This Page Is Inserted by IFW Operations 
and is not a part of the Official Record 



BEST AVAILABLE IMAGES 



Defective images within this document are accurate representations of 
the original documents submitted by the applicant. 

Defects in the images may include (but are not Umited to): 



BLACK BORDERS 

TEXT CUT OFF AT TOP. BOTTOM OR SIDES 
FADED TEXT 
ILLEGIBLE TEXT 
SKEWED/SLANTED IMAGES 
COLORED PHOTOS 

BLACK OR VERY BLACK AND WHITE DARK PHOTOS 
GRAY SCALE DOCUMENTS 



IMAGES ARE BEST AVAILABLE COPY- 

As rescanning documents will not correct images, 
please do not report the images to the 
Image Problem Mailbox. 




United States Patent [I9i m] Patent Number: 5,794,038 

Stutz et aL 145] Date of Patent: *Aug. 11, 1998 



[54] METHOD AND SYSTEM FOR NOTIFIVING 
CLIENTS USING MULTICASTING AND FOR 
CONNECTING OBJECTS USING DELAYED 
BINDING 

p5] Invencors: David S. Stutz. Redmond; Chris T. 

Wcstin, Issaquah, both of Wash. 

[73] Assignee: Microsoft Corporatioo, Redmond, 
Wash. 

[ * ] Notice: The term of this patent shall not extend 
beyond the expiration date of Pat. No. 
5.517.645. 

[21] Appl. Na: 559,6SM 

[22] FUed; Nov. 15, 1995 

Related U^. Application Data 

(63] CooliiitiatioD of Ser. No. 147,6«3, Nov. 5, 1993, Pat No. 
3^17,645. 

[51] Into.* - G06F9/44 

[52] U.S. a 395/<i83; 395/685; 395/200J3 

[581 Fidd of Seardi 395/701. 683. 

395/685. 200J2. 200.33, 200.59 

[56] References Cited 

U.S. PATENT DOCUMENTS 

4,800,488 1/1989 Agniwal et al. ™ 364/200 

5307.490 4/1994 Davidson et al. 395/650 

5^15.703 5/1994 Matbeny et al «. 395/164 

5^17,645 5/1996 Stutz et al 395^00 

5^74.918 11/1996 Hudey et al 395/561 

FOREIGN PATENT DOCUMENTS 

0 474 339 3/1992 Earopcan Pat. Off. G06F 9/44 



0 495 279 7/1992 European Pat. Off. G06F 9/44 

OTHER PUBLICATIONS 

Control Integration and Its Role in Software Integration. 
Genie Logicicl & Systcmcs Experts. J. Arnold and G. 
Memmi. No. 30. pp. 14-24. Mar. 1993. France. 
Distributed Object Computing with CORBA. C++ Report, 
vol. 5. No. 6. pp. 32-38, Jul.-Aug. 1993. USA. 
Alphom: A Remote Procedure Call Environment for Fault- 
I'olerant, Heterogeneous. Distributed Systems, H. 
Aschmann ct al.. IFFF Micro, voL 11. No. 5. pp. 16-19. 
60-67, Oct. 1991, USA. 

COOL: System Suj^port for Distributed Programming. Com- 
munications of the ACM. R. Lea ct al.. vol. 36, No. 9. pp. 
37^. Sep. 1993. USA. 

Object-Oriented EVogram Construction. Wong, W,. Dr. 
Dobb's Journal. Oct 1992. pp. 36. 38, 40. 42, 116. and 118. 

Primary Examiner— Emimel Todd Vocliz 

Assistant Examiner—Kjokaii Chaki 

Attomeyi Ageru, or Firm— Seed and Bcny LLP 

[57] ABSTRACT 

A method and system for managing the connection of client 
components to an interface implemented by a server com- 
ponent In a preferred embodiment, a user component pro- 
vides an implementation of an interface and a description of 
the interface. A conqwnenl manager aggregates the user 
con^xwcnt into itself to form a server component. When a 
client requests a connection to the interface, the component 
manager retrieves a reference to the interface from the user 
component and sends the reference to the client components. 
In a preferred embodiment, the component manager traclu 
Che dient components connected through an interface. A 
user component may also fv^ovide multiple interfaces to 
client components which the component manager also 
tracks. 

17 Claims, 3S Drawing Sheets 



RevenalnterfKB 




M«tho01 
(CMeMtiltcasi 
(Of e*ch eonnocior ontty 
if (connected) 

previnttrtaw *■ tMtot/{. . .) 

) 



1/0« 



09/06/2003, EAST Version: 1.04.0000 



U.S^ Patent Aug. ii, 1998 sheet 1 of 38 5,794,038 




09/06/2003, EAST version: 1.04.0000 



U.S. Patent 



Aug. U, 1998 



Sheet 2 of 38 



5,794,038 




09/06/2003, EAST version: 1.04.0000 



U.S. Patent Aug. ll, 1998 sheet 3 of 38 



5,794,038 




09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 4 of 38 



5,794,038 





09/06/2003, EAST version: 1.04.0000 



U*S. Patent Aug. ii, im sheet 5 of 58 5,794,038 




CD 
EC 



o 
o. 
E 
o 
U 



09/06/2003, EAST Version: 1.04.0000 



U^S. Patent Aug, ll, mS sheet 6 of 38 5,794 




09/06/2003, EAST version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 Sheet 7 of 38 



5,794,038 



CO 

w 
-J 

O 



o 








_i 




Q. 












w 










-t- 



Si 



o 

CO 




(!) 



























UJ 




CO 




3 







09/06/2003, EAST Version: 1.04.0000 



U^S. Patent 



Aug. 11, 1998 



^ Componentlnit 



Sheet 8 of 38 



401 



Allocate 
Component Manager 



402 



Initialize 
Component Manager 



403 



Create Delist 



404 



Component Manager 

pUnkOuter = 
passed pUnkOuter 



Component Manager 
pUnkOuter = 
(lUnknown) & Component 
Manager 



408 



Invoke Create 
callback 



413 



Get request interface 

from Component 
Manager 



414 




411 



Set return 
requested interface 
to lUnknoNAm 



Set return 
requested interface 



412 



Add ref count of 
Component Manager 



5,794,038 




Return (error) 



!) 



C 



Return 



3 



FIG. 4 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent Aug. ll, 1998 sheet 9 of 38 



Component Connect 



9 



501 



Determine which 
connector is a p!ug 




Jack::Connect() 



504 



Plug:: 
Connect and NotifyO 




Jack:: 
NotifyDfdConnectO 




FIG. 5 



09/06/2003, EAST version: 1,04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 10 of 38 



5,794,038 



(component Disconnec^ 




Determine which 
connector is a plug 




603 


pPlug — ► 
Notify Will Disconnect 




604 


pJack — ► 
NotifyAndDisconnect 




605 


pPlug — ► 
Disconnect 




606 


Release plug and jack 







Return 



Return (error) 



FIG. 6 



09/06/2003, EAST Version: 1.04.0000 



Patent 



Aug. 11, 1998 Sheet 11 of 38 5,794,038 



IJack:: 
Connect 





Y , 




703 


Set this jack to 


connecling 




Return (error) 









704 


Set this jack to 


connected 





705 


retrieve pointer to 
reverse interface from 
plug 




706 


set reverse interface 
pointer in this jack 




707 


set reverse interface 
pointer in user 
component 







Return 



FIG. 7 



09/06/2003, EAST version: 1.04.0000 



U.S. Patent Aug. ii, im 



Sheet 12 of 38 5,794,038 



IJack:: 
NotifyDidConnect 



) 






Y 802 


Set this jack to 
connected and not 
connecting 




803 


Invoke connect callback 
of this jack 







Return (error) 



Return 



FIG. 8 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 13 of 38 



5,794,038 




904 



Set this jack to not 
connected and not 
connecting 




905 


Release reverse 
interface 







Return 



FIG. 9 



09/06/2003, EAST Version: 1.04.0000 



U-S. Patent Aug. ii, i998 



Sheet 14 of 38 



5,794 




1003 

Release or reverse 
interface 




FIG. 10 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 15 of 38 



5,794,038 



( 



IPlug:: 
ConnectAndNotify 




Return (error) 



1102 



Retrieve pointer to 


reverse interface 


from 


jack 




1103 



Set reverse interface 
pointer in this plug 



I 1104 

Set reverse Interface 
pointer in user 
component 



1105 



1106 



^x^oes this plugs. y 




have a connect 


Invoke connect callback 


callback 




N 











Return 



FIG. 11 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent Aug. ll, 1998 Sheet 16 of 38 5,794,038 




Set this plug to not 



connected and 
disconnecting 




FIG. 12 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 17 of 38 



5,794,038 






Y 1302 


Release reverse 
interface 




1303 


Set this plug to not 
connected and not 
disconnecting 







Return 



Return (error) 



FIG. 13 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 18 of 38 



5,794,038 



IComponentJack:: 
NewConnector 



1401 



Select descriptor entry 
with passed interface 
and instance name 




Extrude selected 
descriptor entry 



Return 



Return (error) 



3 



FIG. 14 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 19 of 38 



5,794,038 



(DescriplorEntfy;: 
Extrude 




Create initialize 
connector entry 



1503 

Link connector entry to 
CEUSTofthis 
descriptor entry 

1504 

Increment count 
of connectors 



1505 

Set connection ID 
of connector entry 



I 1506 

Increment next 
connection ID of this 

descriptor entry 

1607 



Invoke create callback 




FIG. 15 



09/06/2003, EAST Version: 1.04.0000 



Patent Aug. ii, im 



Sheet 20 of 38 



5,794,038 




09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 21 of 38 



5,794,038 




09/06/2003, EAST Version: 1,04.0000 



U.S. Patent Aug. n, 1998 sheet 22 of 38 5,794,038 



stub:: 
Method N 



1751 



Invoke 
Connector Stub 
Implementation 




1753 



Invoke Method N 
of reverse interface 



Return 



FIG. 17B 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 Sheet 23 of 38 



5,794,038 



IConnector:; 
Passivate 



Retrieve IConnector 
- Interface of 
mate connector 




1803 



Bind to mate connector 



pConnector-*- 
Release Mate < ) 



1805 



1806 




Release reverse interface 



1809 




1808 



Release reverse interface 

stub and set to NULL 
reverse interface pointers 




Create reverse interface 
stub and set reverse 
interface pointers 



1811 



Return 



FIG. 18 



09/06/2003, EAST version: 1.04.0000 



U.S. Patent Aug. ii, ms 



Sheet 24 of 38 



5,794,038 




BindToObject of reverse 
interface moniker 



1903 

Set this connector to not 
connected to a stub 



1904 

Set reverse interface 
pointers 



I 1905 

Retrieve IConnector 
interface of mate 
connector 



1906 



I Connector: 
SetMateConnectorO 




FIG. 19 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent Aug. ll, 1998 Sheet 25 of 38 



5,794,038 



ParentComponent 



20t0 



Component 
Manager 



2011 



( ^CELIST 



tiDJCom- 






ponent Plug 







Projection 
DescriptorEntrv 





ChildComponent 



2020 



Component 
Manager 



Projected 
DELIST 2022 ^pescriptor Entry 



2021 



IID_lCom- 
ponent Jack 



2024 

i 



2026 



2026 



2027 



FIG. 20 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent Aug. ii, i998 



Sheet 26 of 38 5,794,038 




Descriptor entry 
selected 



Return (error) 



3 




Extrude connector entry 



2105 



Retrieve ICIassFactory 
interface of child 



2106 



Create Instance of child 
& retrieve I Component 
interface 



± 



2107 



Set Parent Component 
of child 



2108 



Set Parent Moniker 
of child 



2109 



Create Component 
Moniker for extruded 
connector 



2110 



Set Child Moniker 
of child 



2111 



Release Created 
Moniker 



FIG. 21A 



09/06/2003, EAST Version: 1.04.0000 



U.S» Patent Aug. n, ms Sheet 27 of 38 5,794,038 

V 



NewConnector of Child 
IIDJComponentJack 



Component Connect 



Release Child Connector 




F/G. 21B 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent Aug. ii, im sheet 28 of 38 5,794,038 



(Component Project A 
Descriptor J 

I 2201 



Retrieve IConnector of 
Child Component Plug 



2202 



Release Connector 



2203 



Select Descriptor Entry of 
Child with Passed Interface 
ID and Instance Name 




Select Descriptor Entry of 
Parent Passed Interface ID 
My Instance Projection 
and Native 




Create DE Projected 



2208 



Register Projection 
with Child 



2209 



Link Descriptor Entry to 
Parent DE List 




FIG. 22 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 29 of 38 



5,794,038 






^ 2303 


Set Component full path 
moniker to passed 
moniker 




2304 


Increment refcount of 
passed moniker 







Return 



FIG. 23 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent Aug. ii, i998 



Sheet 30 of 38 



5,794,038 




Increment refcount of full 
path moniker 




FIG. 24 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 31 of 38 



5,794,038 



/Component Manager; 
I SetParentMoniker , 



2501 

■iDoes componem^ 
have a parent 
moniker. 



2502 



Release parent moniker 



N < 



^2503 



2504 



'T)oes comportenr 
^have a full path^ 
moniker. 



Release full path 
moniker 



N k- 



2505 



Set parent moniker to 
passed moniker 



2506 



Increment refcount of 
passed moniker 




Set full path moniker to 
composition of parent 
moniker and this 
moniker 




FtG. 25 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 



Sheet 32 of 38 



5,794,038 



Component Manager 
Rename 



2601 



Select Descriptor Entry 
for Child Components 




Select next connector 
entry for selected 
descriptor entry 



2603 




2605 



Set Parent Moniker of 
component connected 
to selected connector 
entry 



Select next Descriptor 
Entry not a Projection 




Return 



N 2608 



Select next connector 
entry that Is connected 




Y ^ All connector 
^entries selectee 



N 2610 



Release reverse 
interface of selected 
connector entry 



2611 



Release reverse 
interface moniker of 
selected connector 
entry 



FIG. 26 



09/06/2003, EAST version: 1.04.0000 



U.S. Patent 



Aug. II, 1998 



Sheet 33 of 38 



5,794,038 




Set this moniker to 
passed moniker 



2705 



Increment refcount of 
passed moniker 





2706 


Set full path moniker to 
compositton of parent 
moniker and this 
moniker 




2707 


This ► 

Rename 



Return 



FIG. 27 



09/06/2003, EAST Version: 1.04.0000 



U.S. Patent Aug, ll, 1998 sheet 34 of 38 



5,794,038 



/Component Manager;^ 
\Set Parent ComponenJ^ 




Return 
(error) 



FIG. 28 



09/06/2003, EAST Version: 1.04.0000 



U,S. Patent Aug. ii, ms sheet 35 of 38 5,794,038 



C Component:: 
DoEagerBinds 

^ 2901 



Select next 
descriptor entry 




Select next 
connector entry 




Bind stub 



FIG. 29 



09/06/2003, EAST version: 1.04.0000 



U.S. Patent 



Aug. 11, 1998 Sheet 36 of 38 



5,794,038 



o 

CO 

d 




s 












a 








3 




Ql 




c 








4 






09/06/2003, EAST version: 1.04.0000 



U.S. Patent Aug. U, 1998 Sheet 37 of 38 



5,794,038 




CO 

u: 



o 



o 
o 



09/06/2003, EAST version: 1.04.0000 



U.S. Patent Aug. ll, 1998 Sheet 38 of 38 



5,794,038 



cn 
o 

ro 

c 
4) 
c 
o 
a. 

E 
o 
O 
>. 
ra 

Q. 
10 




o 

fO 
■*-> 

c 

0) 

c 
o 
o. 

E 
o 
O 

TO 



09/06/2003, EAST Version: 1.04.0000 



5.794,038 



1 

METHOD AND SYSTEM FOR NOTIFIVING 
CLIENTS USING MULTICASTING AND FOR 
CONNECTING OBJECTS USING DELAYED 
BINDING 

CROSS-REFERENCE TO RELATED 
APPLICATION 

This appUcatioa is a cootinuation of U.S. patent applica- 
Uon Ser, No. 08/147.683, filed Nov. 5. 1993. now U.S. PaL 
No. 5^117.645- 

TECHNICAL FIELD 

This invention relates generally to a computer method and 
system for management of component connection. 

BACKGROUND OF THE INVENTION 

Computer systems often employ object-oriented tech- 
oiques. An object is compos&d of instance data (data 
members) and member functions (method), which lm{de- 
ment the behavior of the object. FIG. lA is a block diagram 
of typical data structures used to rqiresent an object. The 
data structures used to rcFffcsent an object corrqmsc instance 
data structure lAOl. virtual function table lAW, and the 
function members 1A03. 1A04, 1A05. The instance data 
structure lAOl contains a pointer to the virtual function 
table L\02 and contains data members. The virtual fuoctioo 
table 1A02 contains an entiy for each virtual function 
member defined for the object. Each entry contains a refer- 
ence to the code thai implements the cofrespondlog function 
member. The layout of this sample object conforms to the 
model defined in U.S. patent application Ser. No. 07/682, 
537. entiUed 'MErHOD FOR IMPLEMENTING VIR- 
TUAL FUNCnONS AND VIRTUAL BASES IN A COM- 
PILER FOR AN OBJECT ORIENTED PROGRAMMING 
LANGUAGE" filed Apr. 9, 1991, now U.S. Pat. 5^97284. 
which is hereby incorporated by reference. In the following, 
an object will be described as an instance of a class as 
defined by the C++ programming language. One skilled in 
the art would appreciate that objects can be defined using 
other programming languages. 

In the C++ language, object-oriented techniques are sup- 
ported through the use of classes. A class is a user-defined 
type. A class declaratioa describes tikc data members and 
function members of the class. For example, the following 
declaratioD defines data members and a function member of 
a dass named CIRCLE 



cla» CIRCLE 
{ public: 
int X, y; 
int ndhis; 
void dnwO; 

J; 



Variables x and y specify the center location of a cirde and 
variable radius specifics the radius of the cirde. These 
variables are referred to as data members of the class 
CIRCLE. The function draw is a user-defined function that 
draws the circle of the specified radius at the specified 
location. The functioD draw is referred to as a function 
member of class CIRCLE. The data members and function 
members of a class are bound togetficr in that the function 
operates on an instance of the class. An Instance of a class 
is also called an object of the class. 

In the syntax of C-H-, the following statement declares the 
objects a and b to be of type class CIRCLE. 



2 

CmCXE a. b; 

This declaration causes the allocation of memory for the 
objects a and b. The following sutcments assign data to the 
data members of objects a and b. 
5 a.x=2; 
a.y=2; 

a. radius=l; 

b. x=4; 
10 b,y=5; 

bjadius=2; 

The following statements are used to draw the circles 
defined by objects a and b. 

a. draw( ): 

b. draw( ); 

A derived dass is a dass that inherits the characteristics — 
data members and function members — of its base classes. 
For example, the following derived class CIRCLte_FlLL 
inherits the characteristics of the base class CIRCLE. 



class CIRCLEJEI, : CDKCLE 
{ public: 
int pattern; 
voidfiUO: 



This declaration specifies that class CIRCLE_FILL 
indudes all the data and function members that are in dass 

•30 CIRCLE in addition to those data and function members 
introduced in the declaration of dass CIRCLE _FILL. that 
is, data member pattern and function member fill. In this 
example, class CIRCLE.JILL has data members x. y. 
radius, and pattern and function members draw and fill. 

33 Qass CIRCLE _FILL is said to "inherit" the characteristics 
of class CIRCLE. A dass that inherits the characteristics of 
another class is a derived class (e.g.. CIRCLE_JTLL). A 
class that does not inherit the characteristics of another dass 
is a primary (root) class (c.g.. CIRCLE). A class whose 

40 characteristics are inherited by another dass is a base class 
(c.g., CIRCLE is a base class of CIRCLE_FILL). A derived 
class may inherit the cfaaraderistics of several classes, that 
is. a derived dass may have several base classes. This is 
referred to as multiple inheritance. 

45 A derived class may specify that a base class is to be 
inherited virtually. Virtual inheritance of a base dass nxans 
that only one instance of the virtual base dass exists in the 
derived class. For example, the following is an example of 
a derived class with two nonvirtual base classes. 

50 dass CIRCLE_1: CIRCLE {--.}; 
dass CIRCLE_2: CIRCLE { . . . }; 
dass PATTERN: CIRCLE_1, C1RCLE_J{ . . . }; 
In this declaration dass PATTERN inherits class ORCLE 
twice nonvirtually through dasses CIRCLE_1 and 
CIRCLE_2. There arc two instances of dass CIRCLE in 
dass PATTERN. 

The following is an exaniple of a derived class with two 
virtual base dasses. 

gQ dass CIRCLE_1: virtual CIRCLE {...}; 
dass CIRCLE_2: virtual CIRCLE { . . . }; 
class PATTERN: CIRCLE_L CIRCLEL_2{ . . . }; 
The derived dass PATTERN inherits class CIRCLE twice 
virtually through classes CIRCLE_1 and CIRCLE__2. 
63 Since the dass CIRCLE is virtually inherited twice, there is 
only one object of dass CIRCLE in the derived class 
PATTERN. One skilled in the art would appreciate virtual 
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inheritance can be very useful whco the dass derivation is document, the word processing program would need to be 

more complex. recornpikd with the new class dcfioition. Thus, only objects 

A class may also specify whether its function members of classes selected by the developer of the word processing 

are virtual. Declaring that a function member is virtual program can be embedded. Using this technique, new 

means thai the function can be overridden by a function of 5 classes can only be supported with a new release of the word 

the same name and type in a derived class. In the following processing program. 

example, the function draw is declared to be virtual in Jq allow objects of an arbitrary class to be embedded into 

classes CIRCLE and CIRCLE JILL. compound documents, interfaces are defined through which 

— ^— 10 object can be accessed without the need for the word 

ci«t CIRCLE processing program to have access to the class implcmen- 

{ public: tation at compile time. An abstract dass is a class in which 

int %, y. a virtual function member has no implcment^ion (pure) . An 

tai radiu*; interface is an abstract class with do data members and 

vntual void <nwO; . , - n_ _ 

|. whose virtual functions arc all pure, 

class CIRCLE_JTLL : CIRCLE following C++ class definition is an example dcfini- 

\ tion of an interface. In this example, for simplidly of 

StET^ dmwO; explanation, rather than allowing any cUss of object to be 

y, ' embedded in its documents, a word processing program 

20 allows spreadsheet objects to be embedded. An object that 



TheC++languageprovidesapointerdatatypc. Apointer provides an interface is a saver object ^^^J^^^ f^ 

holds i-^^^^^j^^^^^ z;^o!zizi:^^:\T^.^^^ 

mough a points, an object can ^^^^''^^'^l''^^'^ ^ow me object is inmlemcnted. Moreover, any spreadsheet 

J . . — * cessme tJfOflram IS corapilea, can be cmijeaaea. 

the address of object c. s r »• -r 

CIRCLE *c_4>tr, ^— ^— ^— — — 

C^4}tr=&c; cUu ISpreadSbeei 

Continuing with the example, the foUowing statement { virtual vok! Rk() - O; 

declaresobjcctatobcoftypeclassCIRa^andobjectbto « SS™SS^==o; 

be of type dass CIRCLE_FILL. virtual void PonnaK) = o-. 

CIRCl-E a* virtual vokl GctCell (sninj RC, cell *pCeU) = 0; 

aRCLE_FILLb; virtual void = O; 

The following statement refers to the f\jaction draw as ^ 
defined in dass CIRCLE. 

a. draw( ); The developer of a spreadsheet program would need to 
Whereas, the foUowing statement refers to the function draw provide an implcmcntatioQ of the interface to allow the 
defined in class CIRCLE-FILL. spreadsheet objects to be embedded in a word processing 

b. draw( ); 40 document When the word processing program embeds a 
Moreover, the foUowing statements type cast object b to an spreadsheet object, the program needs access to the code that 
object of type class CIRCLE and invoke the function draw implements the interface for the spreadsheet object To 
thai is defined in class CIRCLEJTLL. access the code, each implementation is given a unique class 

CIRCLE *c_ptr; identifier. Foe cxanople, a spreadsheet object developed by 

nteaAb- ' 45 Microsoft Corporation may have a class identifier of 

~^^r'.u,^ V // rntcin FHX -drawf 1 **MSSprcadsheet" while a ^adsheet object dcvcl<^ by 

S.j«t stniaur^. Per ««nplc. object-oriented ledhnlques *«>t jrogr™ « msaUrf ou %""*^J^'^J^,P^ 

^adsheet object generated b? a spreadsheet program is a objecu into a word processing document 

compound document. A word processing program aUows a Various spreadsheet developers may wish, howcvw. to 

user to embed a spreadsheet object (e.g., a ccU) within a implement only certain function members. For example, a 

word processing docuioent In one way to allow this « spreadsheet developer may not want to implement daUbasc 

embedding, the word processing program is typicaUy support, but may want to support aU other fiincUon mcm- 

compilcd. using the class dcfiniUon of the object to be bers. To allow a spreadsheet developer to support only some 

embedded, to access function members of (he embedded of the funcUon members, while still allowing the objects to 

object Thus, the word processing program would need to be be embedded, multiple interfaces for spreadsheet objects arc 

compUed using the class definition of each class of objects 63 defined. For cxan^jlc. the interfaces IData and IBasic- 

thalcan be embedded in a word processing document. To Spreadsheet may be defined for a spreadsheet object as 

embed an object of a new class into a word processing follows. 
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class IBuicSpreadsbeel 

\ virtual void FileQ = 0: 
virtual void Edi(0 = 0: 
virtual void Fonnulaf) = 0; 
virtual void Format() = 0; 
virtual void GctCell (itrin« RC, ceU •pCeU) = 0^ 

\ 

class IData 

{ virtual void Data() = 0: 

^ 



Each spreadsheet develt^er would unplement the IBasic- 
Spreadsheet inteiface and. optionally, the IData inlcrfacc. 

At run time, the word processing program (or any other 
client of the interface) would need to dctcmiinc whether a 
spreadsheet object to be embedded supports the IData inter- 
face. To make this determiaation, another interface is 
defined (that every spreadsheet object implements) with a 
fii action metuber that indicates which interfaces are imple- 
mented for the object This interface is named lUntnown 
(and referred to as the unlmown interface or the object 
management interface) and is defined as follows. 



class lUtdmows 

I vuml HRESULT QuetylhierfKe (REFIID iid, void ••ppv) = 0; 
vimuU ULONG AddRefO = 0; 
viitual ULONO Kclcue 0 = 0; 

\ 



The lUnknown interface defines the function member 
(method) Queiylnterface. The method Quciyintcrface is 
passed an interface identifier (e.g.. 'IData**) in parameter lid 
(of type RBFIID) and returns a pointer to the implcmcota- 
tioo of the identiiied inteiface for the object for which the 
me^Kxl is invoked In parameter ppv. If the object does not 
suppon the interface, then the method returns a false. (The 
type HRESULT indicates a predefined status, and the type 
ULONG indicates an unsigned long integer.) 

CODE TABLE lA 



HR£SULT XX::QueiyInterfacefREFin> iid, void **pinr) 
{ ret = TRUE; 
switch (iid) 

{ COM nD_IBuk:SptudfihMt; 

•ppv s •pIBMcSpreadsbeet; 

break; 
case IID_jDatabase; 

•ppv = •plIHta; 

break; 
caas nD_HJnkix>wii; 

•ppv = this; 

break: 
default: 

ret - FALSE; 

} 

tf(rel »TRUE){ AddRefO;}: 
return ret; 

} 



Code Table lA contains C-H- pseudocode for a typical 
implementation of the method (Jucryinterfacc for dass XX. 
whidi inherits the class lUnknown. If the spreadsheet object 
supports the IData interface, then the method Queiylnteiface 
indudes the appropriate case labd within the switch state- 
ment. The variables pIBasicSpreadsheet and pIData point to 
a pointer to the viitual function tables of the IBasicSprcad- 
^eet and IData interfaces, respectively. The method Quc- 
iyintcrface invokes the method AddRcf (described below) to 
increment a reference count fa the object of class XX when 



6 

a pointer to an interface is returned. 

CODE TABLE IB 

void XX;:AddRef() {refcounH-^i^ 

void XX: :ReleaseO { ilt~refcoui]l=0) delete this; | 



The interface lUnknown also defines the methods AddRef 
and Rdease, which are used to implement reference count- 
jQ ing. Whenever a new reference to an interface is created, the 
method AddRef is invoked to increment a reference count of 
the object. Whenever a reference is no longer Deeded, the 
method Rdease is invoked to decrement die reference count 
of the object and. when the reference count goes to zero, to 
deallocate the object Code Table IB contains C++ 
pseudocode for a typical implementation of the methods 
AddRd" and Rdease for dass XX, which inherits the class 
lUnknown. 

The IData interface and IBasicSpreadsheet interface 
inherit the lUnknown interface. The following definitions 
20 illustrate the use of the lUnknowo interface. 



class IData : public lUnknown 
\ public: 

vataai void I>ata() = 0; 

^ } 

class IBasicSpieadsbeet : public lUnknowD 
{ public: 

virtual void Fifc() = 0; 
virtual void Bdi^> = 0; 
virtual void FonuiilaO = 0; 
30 v'ataal void Fonnat() = 0; 

virtual void OetCell (string RC, cell •pCell) = 0; 

\ 



FIG. IB is a block diagram illustrating a sait^le data 

35 structure of a ^cadshect object The spreadsheet object 
comprises object data structure IBOl. IBasicSpreadsheet 
interface data structure tB03, IData interface data structure 
1B(M. me vinual function tables IBQ2, 1B05. 1B06 and 
methods 1B07 through 1B21. Hie object data stnicture IBOl 
contains a pointer to the vinual function table 1B02 and 
pointers to the IBasicSpreadsheet and IDau interface. Each 
entry in the virtual function table 1B02 contains a pointer to 
a niethod of the lUnknown interface. The IBasic interface 
data structure IB03 contains a pointer to the viitual function 

4^ table IB 05. Each entry in the virtual function table 1B05 
contains a pointer to a method of the IBasicSpreadsheet 
interface. The IData interface data structure IBM contains a 
pointer to the virtual functioo table 1B06. Each entry in the 
virtual function table 1B06 contains a pointer to a method of 

50 the IData interface. Since the IBasicSpreadsheet and IData 
interfaces inherit the lUnknown interface, each virtual func- 
tion table 1B05 and IBOti contains a pointer to the methods 
Queiylntcrface, AddRef. and Release. In the following, an 
object data structure is rq)resented by the sh^ 1B22 

55 labeled with the interfaces through which the object may be 
accessed. 

The following pseudocode illustrates how a word pro- 
cessing program determines whether a spreadsheet object 
supports the IData interface. 
60 if (pIBasic->QueryInterfacc('*IData*'. ^^IData>=S_OK) 

\* IData supported else 

\* IData not supported 
The pointer pIBasicSpreadsheet is a pointer to the IBasic- 
Spreadsheet interface of the object If the object supports the 
63 IData interface, the method Quei>tnterface sets tfie pointer 
pIData to point to the IData data structure and returns the 
value S_OK. 
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Normally, an object can be instantiated (an instance of the FIG. 4 is a flow diagram of the function ConiponenUnit. 

object created in memory) by a variable declaration or by the FIG. 5 is a flow diagram of the function ComponentCon- 

"ncw" operator. However, both techniques of instantiation ncct. 

need the class definition at compUe time. A different tech- jqQ 5 a flow diagram of the function ComponentDis- 

niquc is needed to allow a word processing program to 5 connect, 

instantiate a spreadsheet object at run time. One technique y -^^ ^ diagram of the method Connect of the 

provides a global fijnclioR CrcatcInstanccXX. which is Uack iotcrfacc. 

defined in the foUowing. g ^ diagram of the method NotifyDidConnect 

static void Great eInslanceXX (REFHO iid, void ''ppv) ^j^^ interface. 

„ \ , „ , „ , * ^ ^ FIG. S> is a flow diagram of the method Notify AndDis- 

The method OeatelnstanccXX (known as a class factory) rt,^ ir-Hf InS^rfari. 

instantiates an object of class XX and returns a pointer ppv '""^^ ,''l^„'''Z , n- 

to the interface of the object designated by paiamcter ud. , ^ 10 is a flow diagram of the method Disconnert of the 

Hack interface. 

SUMMARY OF THE INVENTION j^q ^ ^ diagram of the method ConnectAnd- 

D is an object of die present invention to provide a method Notify of the Mug interface. 

and system for managing the interactioD between compo- piG. 12 is a flow diagram of the method NotifyWillDis- 

nents. connect of die IPlug interface. 

It is an object of the present invc ntion to j^ovide a method pjQ 13 is a flow diagram of the method Disconnect of the 

and system that is not limited to any single problem domain. 20 ipiug interface. 

It is an object of the present invention to provide a method pjQ 14 is a flow diagram of the method NewConnector 

and system for managing the interaction between compo- ICaraponcntlack interface. 

ncnts that can be shared by aU conqxjnents. jj ^ diagram of the method Extrude of Ac 

It is an object of the present invention to provide a method ii>escript«rEntry interface, 

and system for managing the interacUon between compo- ^ ,^ ^ ^ iUustrating lazy binding, 

nents in a way that minimizes overhead. ^ ^ ^^^^ 

It ,s another object of the present mvenUon to provide a ,f ^^e multilist interface stub, 

^^nd system to store components pers^tenUy across ^ ^^^^^^ ^ ^^^^ 

These and other objects, which will become apparent as ^ ^ , 

the invention is described in detail below, are provided by a FIG. 18 iS a flow doagram of the method Passivatc of the 

method and system for managing the connection of dient IConnector interface. 

co^^)oncnts to an interface implemented by a server com- FIG. 19 is a flow diagram of the mrtbod BindSlub of die 

ponent. In a preferred embodiment, a user conq>onent pro- IConnector interface. 

vides an implementation of an interface and a description of FIG. 20 is a block diagram illustrating a parent component 

the interface. A component manager aggregates the user and a child con^nent. 

component into itself to fonn a server component When a pios. 21A and 21B comprise a a flow diagram of the 

client requests a connection to the interface, the con^ncnt function ComponentCreateOuld. 

manager retrieves a reference to the interface from (he user ^ pjQ 22 is a flow diagram of the function Component- 
component and sends tbe refererwe to the client components. projectDcscriptor. 

In a preforcd embodiment, the component managw tracks 23 is a flow diagram of the method SetMonika of 

the cUent componenU connected dirough an mtaface. A iComponent interface. 

user oonqwncnt may abo provide multiple "^tcrfaces to GetMoniker of 

cUen^ components which the conqx^nent manager also JSLrComponentM^ager. 

FIG. 25 is a flow diagram of the method SetParentMoni- 

BRIEF DESOUFnON OF THE DRAWINGS j^^^ ^lass ComponeatManager. 

FIG. lA is a block diagram of typical data structures used no. 2* is a flow diagram of the jwivate meAod Rename 

to rqjresent an object of the IComponent interface. 

RG. IB is a block diagram Illustrating a sample dau ^ piG. 27 is a flow diagram of the method SctChildMonikcr 

structure of a spreadsheet object of (he IComponent interface. 

FIG. IC is a block diagram iUustrating a unidirectional pjQ 28 is a flow diagram of the method SetParcntCom- 

connection. ponent of the ICon^wnent interface. 

HG. ID is a block diagram illustrating a bidirectional 3 diagram of the method DoEagerBinds of 

connection, the ICompooeDt interface. 

FIG. IE is a block diagram illustrating multiple conncc- nG. 30 is a block diagram illustrating a sample system 

tions through a protocol ^^^jg ^^^^j^^ invenaon. 

FIG. IF is a block diagram illustrating a component tiiat j^. ^ diagram of the display of a sample visual 

supports multiple protocols, ^ program. 

FIG. 2A is a block diagram illustrating the structure otf a 32 ^ diagram of the instantiated con^ 

preferred component oents. 

FIG. 2B is a block diagram illustrating a preferred data ™ ™,w^ 

structure of a compooent^nager. ^^'^^S^SSS 

no. 3 is a block diagram illustrating an exan^ile of a 65 INVENTION 

connection between two components in a prefened crabodi- The present invention provides a method and system for 

nient managing the sharing of interfaces between components. In 
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a prefeired embodimeot, a user compooent provides an illustraling multiple connections throug}] a protocol. The 

in:^)lcincntation of an interface and a description of the server 121 provides the IServer interface and clients 122 and 

interface. A component manager aggregates the user com- 123 each provide an iraplcrocntation of the IClient interface, 

ponent into itself to foira a server component. When a client The server 121 contains a pointer to each IClient interface, 

component requests a connection to the interface, flie com- j and each client 122 and 123 contains a pointer to an IServer 

ponent manager retrieves a refercDce to the interface from interface. The seiver 121 may provide difFereat pointers to 

the user conyoncnt and sends the reference to the cUent ^Ucm to aUow the server to maintain state information 

component. In a preferred embodiment, the con^wnent for each cUent and to identify the client requesting a service, 

manager tracks (he client conaponcnts connected through an . 

interface. A user component may also provide multiple ^ component may also support multiple protocols and 

interfaces to cUcnt components which the component man- [^^'J^*'^ connecUons may be established for each protocol, 

agcr also tracks. » "i***^*^ diagram dlustrating a component that 

A «.m™«.«r «r««j^« ^ ^ supports multiplc protocols. Server 131 supports the 

A coiqwncnt provides services to vanous other compo- .a * i j .i. tp 

ncnts. Tl^ services are provided through an IntcrfaceXi Bcryeri^CUentA protocol «.d the BervaMCbentB pro- 

the component implcmenl^. A component that provides an ,5 1^' ^"i"^ Z V T ^Tl^ ^.t 

interfacT^ irfeired to as server c^nent (se!ver). and a ^Z^?^""""^ ' ^ '"1 ^ 

component that uses the services of ^ interface is a client ^"^'"^ ^""^ ^= BerverBaOientB ,^otocol. 

con^KWcnt (client). A client component is passed a pointer present invention provides a method and system for 

to the interface and requests services by invoking the controlling the establishing of connects between corapo- 

racthods of the interface. In certain cases, the cUcnt com- jq nents. In a preferred embodiment, a component that provides 

ponent may want to be notified directly by the serva *•> implcmcntaaon of an interface of a protocol is a user 

component of some event, or the server component may compooent A user component is aggregated with a compo- 

want to retrieve information from its client component. In manager object to form a component object The 

these certain cases, the client component provides an compooent manager object (component manager) manages 

interface, referred to as a reverse interface, to the server « the estaWJshing and tracking of connections to the interfaces 

component. The server component is passed a pointer to the Provided by the user component. The con^wnent manager 

reverse interface and requests services by invoking methods provides interfaces through which connecUons can be estab- 

of the reverse interface. TVpicaUy, a saver component * domain independent manner. 

I^ovides a specific interface and request services of the FIG. 2A is a block diagram illustrating the structure of a 

client con^xjnent through a specific reverse interface. The jq preferred component. Component object 201 oompiises 

combination of the specific interface and reverse interface is conqx>ncnt manager 202. user c<Hi^nem 203. aitd conoec- 

known as a protocol Protocols may be either unidirectional tor objects 204 (connectors). The component manager 202 

or bidirectional. A unidirectiooal protocol is one in which the manages oonncctiog the component 201 to other con^x>- 

clieot component does not provide a reverse interface. Thus, ncnts through protocols provided by the user component 

services arc only provided by the server con^nent. A 33 203. The component itiana^ provides an IComponentMan- 

bidirectional protocol is one in which both the cUent and ager interface for contrc^ling die connecting of components, 

server components provide interfaces. Thus, services are The user component 103 provides the domain specific 

provided by both the server and client components. A behavior of the interfaces. The connectors 104 are created by 

connection is established via a protocol between a server the conqxinent manager, track the state of connections, and 

compooent and a client con^nent by passing a pointer to ^ provide an IC!onoector interface for controlling connections, 

the interface from die server to the client and if the protocol FIG. 2B is a block diagram illustrating a preferred data 

is bidirectional, passing a pointer to the reverse interface structure of a con^wnent manager. A component 211 com- 

from the client to (he server. prises a component manager 212 and a link list of connector 

FIG. IC is a block diagram illustrating a unidirectional descriptor entries 213 (a DEUst). Each descriptor entry 

connection. The server 101 provides (he IServer interface to 43 points to a link list of connector entries 214 (a CEUst) and 

the dicnt 102, The client 102 contains a pointer to the to a connector descriptor 215. The oomponeot manager 

IScrver interface. FIG. ID is a blodc diagram illustrating a creates one descrq>tar entry for each protocol provided by 

bidirectional connection. The saver 111 provides the ISer- the user con^oent The conqxMient maiuger creates a 

ver interface, and the client 112 provides the IClient inter- connector entry for each connection for the given protocol, 

face. The server 111 contains a pointo: to the IClient 30 Each connector descriptor is provided by the user compo- 

interface. and the client 112 contains a pointer to the IServa ncnt and describes one protocol provided by the user com- 

intcrfacc. The server 111 and the dicnt 112 arc connected via ponent. The coiiq>oneot manager 212 points to the user 

the Bcrver/IClient protocol con^Kment 216 and a component descriptor 217. The com- 

In the case of a bidirectional protocol, both the server ponent dt&aipUx Is provided by the user component and 

component and the client component provide services to the 35 describes attributes of the component, 

other. Thus, each component can be considered to be both a llic present invention provides various functions that can 

server and a client of services. By specifying a certain be used to connect components. In one embodiment, these 

protocol that it supports, a component is identifying services functions can be provided through an ICompooent interface 

it provides and services it requires of a dicnt component. In provided by a oon^wnent manager. A basic function is die 

the following, one interface of a prcAocol will be referred to 60 function ComponentNcwConnector. which "extrudes" a 

as a jack interface, and the other interface will be referred to connecter for the specified protocol. To extrude a conoector. 

as a plug interface. The compooent that provides the jack the component manager creates a new connector entry for 

interface is said to provide the jack oonncctioo of the the specified protocol and returns a pointer to (he IConnector 

protocol, and the component that provides the plug interface interface of the new connector entry. When both a plug and 

is said to [Hovide the plug connection of the protocol « a jack connecter for a protocol arc extruded, they can be 

A component may allow multiple connections to be connected with the fiinction C^mponeniCoonect. The ftinc- 

established for a protocol. FIG. IE is a block diagram tioo ComponentConnccl stores a pointer to the reverse 
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interface in each user component and initializes slate infor- 
mation to track the connection. FIG. 3 is a block diagram 
illustrating an example of a connection between two com- 
ponents in a prefeiTcd embodiment. Components 301 and 
311 arc to be connected via ttic lUSERJACK/IUSERPLUG 
protocol. Component 301 contains conqwnent manager 302 
and descriptor entry 303. which describes the lUSERJACK 
interface. Compoocnl 301 is requested to extrude jack 
connector 304 for the lUSERJACK interface. The compo- 
nent manager 302 searches the descriptor entries for the 
lUSERJACK interface entry 303 and instantiates jack con- 
nector 304. The jack connector 304 contains a pointer to the 
lUSERJACK interface provided by the user component 305. 
Similarly, componeat 311 contains con^mnent manager 312 
and descriptor entry 313. which describes the lUSERPLUG 
interface. Component 311 is requested to extrude plug 
connector 314 for the lUSERPLUG interface. Hie compo- 
nent manager 312 scardies the descriptor entries for toe 
lUSERPLUG interface entry and instantiates plug connector 
314. The plug connector 314 contains a pointer to tfie 
lUSERPLUG interface provided by the user conqwnent 
315. 

Once the jack connector 304 and the plug connector 314 
are extruded, then the con^ncnts can be connected throu^ 
these connectors. In one embodimcm, a function Con^x)- 
nentCoDoect is passed both the jack connector 304 and the 
plug cMnDCCtor 314 by passing pointers to their iConnector 
interface. The function CompooentConncct sets the jack 
connector 3(M and the user component 305 to point to the 
lUSERPLUG interface (illustrated by dashed lines). 
Similarly, the function ComponcntCcMincct sets the pUig 
connector 314 and the user connpooent 315 to point to the 
lUSERJACK interface (illustrated by dashed lines). Hie 
user con^nents 305 and 315 can now access the methods 
of their reverse interfaces through the reverse interface 
pointers. 

CODE TABLE 2A 

souct CoaipaaeBiDKsciitKx 

ULONO aag; 
ULONO cCooDccton; 

const CoBDCccurDescnptOT FAR •pConnDcac; 
HRESULT (FAR •CpmIb) {lUnknowD FAR •pUnkOuteti 
struct CtnqpooeiitMani^ FAR 
lUnknowa FAR •PAR •ppIUnk, 
REFCL5ID cisid): 



CODE TABLE 2B 



ttnicl CoooectorDMcrqitar 



i 



ccKUt nD *pud; 
coast nD 'piidiii; 
LPCTSTR mime; 
ULONO fits; 
tnX>HG cMuCcnneclors: 
»iie_t RcvlSacePoOff; 

nJnknawn FAR '(FAR •Cirate) (lUDtnowo FAR •pCooOoUer, 

rUafajown PAR •pComponeotX 
void {FAR •DclcteXIUnkDown FAR *pCoimector); 
vok) (FAR •ConDcciyiUnknown FAR •pCooaector); 
void (FAR •DiacooncctXIUnknown FAR •rCoQaoctor), 



During conqxjncnt creation, the user component provides 
to the component manager a component descriptor. Code 
Table 2A contains a component descriptor data structure. 



The con^ncnl descriptor contains a pointer an array of 
connector dcscriptCM-s (pConnDcsc), a count of the number 
of entries in the array (cCoonectors), a pointer to a create 
callbadt routine into the user component (•Create), and a 
5 flag (flag). The component manager invokes the create 
callback routine during component creatfoo. The flag 
describes various attributes of the oomponent as described 
below. 

Each connector descriptor contains the interface id of the 
to interface provided by the user component (piid) and the 
corresponding reverse interface id (piidm). an instance name 
(iname), maximum number of connectors 
(cMaxConncctors), die offset of the reverse interface pointa 
in the user component (RevIfacePtiOff). various callback 
13 routines into the user con^oent. and a flag (flag). Code 
TaWc 2B contains a connector descriptor data structure. The 
interface id specifies the interface of the protocol that the 
user component provides and ttie reverse interface id speci- 
fies the interface that the user component expects to be 
20 provided by the connected to oomponent The instance name 
is used (0 distinguish multiple implementations of the same 
protocol that arc provided by the user component. The 
maximum number of connectors indicates the maximum 
number of connectors for the described protocol that can be 
23 extruded at one time. The offset of the reverse interface 
pointer into the usa con4>onent indicates to the conqMnent 
manager the location of the reverse interface pointer relative 
to the provided interface pointer. The component manager 
notifies the user component of changes in the state of 
30 connection through various callback routines. In a preferred 
embodiment, a user con^wnent is notified that a connector 
is extruded, connected, disconnected, and deleted through 
callback routines. The flag describes various attributes of the 
connector as described below. 

The present invention provides various functions to create 
connectors and establish connections between components. 
The functions Include a function to create a new connector 
(ComponentNewConnector). a function to connect two con- 
nectors (CcwnponentConnect), a function to disconnect two 
^ connectors (ComponcntDisconncct). and a function to delete 
a connector (ComponentEteleteConnector), In addition, a 
prefarcd embodiment also provides functions to enumerate 
the connector descriptors and the oonnectcn^. 

The present invention also provides a functton to initialize 
the component managa (CompoDentInU). When a user 
component is created, the user ooraponent class factory 
invokes the function Componendnit passing the class id of 
the user component and a component descriptor that points 
to an array of connector descriptors. The function creates a 
^ component manager object and creates and aggregates die 
user conqKment. (The aggregation of objects described in 
U.S. patent appUcaUon Ser. No. 07/996.352. entitled 
"METHOD AND SYSTEM FOR AGGREGATING 
OBJECTS." filed Dec. 24. 1992. now abandoned, which is 
hereby incorporated by reference.) The function also creates 
the DEList corresponding to the array of connector dcscrip- 
ton. A prcfened prototype of the function Componentlnit is 
STDAPI Componentlnit 
lUnknown FAR *pUnkOuter. 
REFHD riid, 
lUnknown FAR "FAR ♦ppIUnk, 
const ComponentDescriptor FAR ♦pCompDesc. 
REFCLSm clsid); 
63 The parameter pUnkOutcr points the controlling lUnknown 
interface: the parameter riid is the interface id of the inter- 
face to be returned in paranttter ppIUnk; the parameter 
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pCompDesc is a pointer to the component descriptor; and ConncctAndNotify of plug connector returns, Ihcn the func- 

parameter dsid is the dass id of the user compoocnt. FIG. tion invokes the method NolilyDidConoect of the jack 

4 Is a flow diagram of flic function Componentlnit. In step connector. The user component of either component may be 

401, the function allocates a component manager object In notified via the connect callback specified in the connector 
step 402, the function initializes the component manager by j descriptor. By convention, the user component of the plug 

^^^L ^ connector is notified of flic connccUon by the component 

and adds a desCTiptor entry to tfie DEList corrcijwnduig to „ ^f^,^ ^ser component of the jack connector is 

^di connector descriptorspecified m the aixay of connector ^h^^ , j ^^^^^^^ ^^ ^^^^ 

descriptors In steps 404-407 the funcUon aggregates the connection specific iJiUaUzation. A preferred proto^ of 

component into an aggregate objert if the parameter pUnJ- ^^^^^ ComponcntConncct is 

n "°f ^* ' "^"^ STDAPI CompoDentConnect( 

pUnkOuter for the con^wneot manager equal to the paranv „ „ . ^ 

etcr pUnkOutcr. In step 405. if the parameter pUnkOutcr IConncctor FAR ♦pIConncctorl 

equals NULL, then the funcUon continues at step 406. else IConncctor FAR •pIConncctor2); 

the function continues at 407. In step 406. the function sets The parameters pIConncctorl and pIConnector2 point to the 

tiie pUnkOuter of the con^wnent manager to point to the connectors to be connected. FIG. 5 is a flow diagram of the 

lUnknown interface of the coraponent nunager and contin- function ComponentConnecL In step 501. the function 

ues at step 408. In step 407. if the requested interface is not determines which connector is a plug. In st^ 502, if the 

the lUnknown interface, then the function returns. In step connectors do not represent reverse interfaces of a protocol. 

408, the function invokes the ocatc callback of the usa then the function returns an error. In step 503. the function 
component specified in the component descriptor. The create ^ invokes the method Connect of the jack connector passing a 

callback creates a user component and aggregates it into tfic pointer to the plug connector. The method Connect returns 

conapooent. The function sets the component mnnager to ^ Indicating wheftcr the jack connector is to be notified 

point to the user component In steps 409 through 414. the connection to the plug connector is complete. In 
ftinction retrieves a pointer to the interface specified by the . stcp 504. the function invokes the method ConnectAndNo- 

paranoctcr riid. In step 409. if the parameter pUnkOutei is ^ ^ the plug connector passing a pointer to the jack 

NULL, then the function amtinues at step 413, else the connector. In step 505. if the jack connector is not to be 

function continues at step 411. In step 411. the function sets notified, then the function returns. In stq) 506. the function 

the requested interface to the lUnkncwn intafacc. In step invokes the method Notify IXdConnef^ of the Jack conneciw 

412. the function increments the reference count of flie and remrns. Once a connection is established, the user 

component manager and returns. In stq) 413. the function compOTcnts can use the reverse interface pointer to access 

retrieves the requested interface by invoking the method the methods of the interface. 

Queiylntetfaoe of the controlling lUnknown. In step 414. A connection is broken by invoking the function Com- 
the function returns the requested interface. poncntDlsconnccl. The function Con^nentDisconnect 
Once a component is created and initialized, connectors ensures that the passed connectors are connected and detcr- 
may extruded and connected. The function ConqwnentNew- "^es which connector is the jack and plug connector. The 
Connector creates a connector for the specified interface id function then invokes the method NotifyWillDisconncct of 
and returns a pointer to the IConnectOT interface of flie the plug connector, the mcdiod KotifyAndDisoonnect of the 
connector. A preferred prototype of the function Con^ j*ck connector, and the method Disconnect of the plug 
nentNewConnector is connector A preferred prototype <rf the function Compo- 
SFDAPI ComponentNcwConncctoff( nentDisconncct is 
ComponcntManager FAR "pCM, CTDAPI ComponentDisconnect( 
RHFnD riid. IConncctor FAR *pIConnectorl, 
LPCTSTR pName. IConnectOT FAR •pIConnector2); 
IConncctor FAR * FAR *FpIConnector); 43 The parameters pIConncctorl and prconnector2 ptant to the 
The parameter pCM points to the component manager of the IConncctor interfaces of the connectors to be disconnected, 
component; the parameter riid is the interface id of and the FIG. 6 is a flow diagram of the function ComponentDiS' 
parameter pNamc is the instance name of the descriptor connect In stq> 601. if the passed connectors are not 
entry describing the protocol for which a connector to be connected, then the function rehims an error. In step 602. the 
created; and the parameter ppIConnector is a pointer to ^ 50 ftinction determines which connector is a plug and a jack. In 
created connector. The connector contains a pointer to the stq) 603. the function invokes the method NotifyWUlDis- 
interface provided by tf»c user component The ftinction connect of the frtug connector. In step 604. the function 
invokes the create callback for the descriptor entry to invokes the method NotifyAndDisconnect of the jack con- 
retrieve the pointer to the interface. In a preferred nector. In step 605, the function invokes the mctfiod Dis- 
embodiment, the function ComponentNewConnector S3 connect of the plug connector. In stq) 606. the function 
invokes a method NewConnector of the IComponcntJack releases the plug and jack connectors and returns, 
interface of the passed component manager to aeate a new 

connector. The method NcwConncctor is described below. CODE TABLE 3 

A connection is established by invoking the fimction ■ 

ComponcntConncct This function is passed pointers to two 6o 5**" 

conneciQis (IConncctor interface). The function deteimines stomcthod Coonecit 

which connector is a plug and a jack, and ensures that they iPlua far "piP. 

represent reverse interfaces of a |a-otocol. The function then \Jlova far •pCDFlaj. 

invokes the method Connect of the jack connector and then mv^ 

die mediod ConncctAndNotify of the plug connector. If the 65 nD far •pPhignD'>=0; 

method Connect of the jack connector returns an indication stdmethod Notifyi>idCamcetO=o: 
that the jack connector is to be notified when the method 
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CODE TABLE .^-continued 
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^ 



STOMEIHOD NotifyAndDtscorD«t(>=0; 
STDMEIHOD Disconaeci<>=0: 



class IPhig 

STDMETHOD ConoectAndNotify(>=0; 
STOMETHOD NotifyWUIDi3coiincct(>=0; 
STDMETHOD DiacCTinect(>=0; 

i 



10 



Code Tabic 3 contains thc interface descriptions for the 
Uack and IRug inteifaccs. A jack connector provides thc 
Uack interface and a plug coonecttw provides the IPlug 
interface. The methods of these interfaces arc used to '5 
establish the connection between components. 

FIG. 7 is a flow diagram of the method Connect of the 
Uack inleiface. The method is passed a pointa to a plug 
(pIP> and connects this jack (indicated by the "this" pointer) 
to that plug. The method returns thc identifier of thc jack and 20 
plug interfaces (pJackllD) andpRugllD). a descriptive flag 
for this jack (pCDflag). and a flag indicating whether this 
jack is to be notified when thc connection is complete 
(pFlag). In step 701, if this jack is connecting or connected, 
then the method returns an eiror. In step 702, if the user 25 
component for diis jack wants to bc notified, as indicated by 
the connect callback, then the method continues at 703. else 
fee method continues at 704. In step 703. the method sets 
this jack to indicate connecting, in step 704. thc method sets 
this jack to indicate connected. In step 705. thc method 30 
retrieves a pointer to the plug interface from thc passed plug. 
In step 706. thc method set thc reverse interface pointer of 
this jack. In step 707. the method sets thc reverse interface 
pointer of the user component and returns. 

FIG. 8 is a flow diagram of thc method NotifyDidConnect 35 
of the Uack interface. This method notifies thc ustr com- 
ponent of thc connection. In step Ml, if this jack is not 
connecting, thc method returns an error. In step 802, the 
method sets this jack to indicate connected and not connect- 
ing. In step 803. thc method invokes the connect callback of 40 
the user component as indicated by the dcscrqrtor cntiy (rf 
this jack and returns. 

FIG. 9 is a flow diagram of the method NotifyAndDis- 
connect of the Uack interface. In step 901, if this jack is not 
connected, then thc method returns an error. In step 902, if 45 
the user component is to be notified of the disconnect, then 
the method invokes thc disconnect callback in step 903. In 
step 904, the method sets this jack to indicate not connected 
and not connecting. In step 905, the method releases thc plug 
interface and returns. SO 

FIG. 10 is a flow diagram of the method Disconnect of the 
Uack interface. In step 1001, if this jack is not connected or 
connecting, then the method returns an cir«. In step 1002. 
&e me&od sets this jack to indicate not connected and not 
connecting. In step 1003, die method releases thc plug 55 
interface and returns. 

RG. 11 is a flow diagram of the method ConncctAnd- 
Notify of the IPlug interface. In step 1101. if this plug is 
already connected, then the method returns an error. In step 
1102, thc method retrieves a pointer to thc connected to jack 60 
interface. In step 1103, the method sets the reverse interface 
pointer in this plug to point to thc jack interface. In step 
1104, (he method sets the reverse interface pointer of the 
uscr component to point to the jack interface. In step 1105. 
if thc user component is to be notified of the coonectioo, then 65 
thc method invokes thc connect callback of this plug in step 
1106. The method then returns. 



FIG. 12 is a flow diagram of the method Notify WiUDis- 
conncct of thc IPlug interface. In step 1201. if this plug is not 
connected, then the method returns an error. In step 1202. if 
thc user component is to bc notified of the disconnect, then 
the method invokes thc disconnect callback in step 1203. In 
step 1204. the method sets this plug to indicate not con- 
nected and disconnecting and returns. 

FIG. 13 is a flow diagram of the method Disconnect of the 
IPiug interface. In step 1301, if this plug is not 
disconnecting, then the method returns an error. In step 
1302. the method releases the jack interface. In step 1303, 
the method sets this plug to indicate not connected and not 
disconnecting and then returns. 



CODE TABLE 4 



class ICctDpoocDiIack: lUnksowo 



\ 



sn^METHOD EiiiimerateDescriptorG( 

lEaumDescr^tor FAR •FAR •pplEiiiiiiiDMc, 
t JLONO At, 
REFIID ltd, 

LPCTSTR lpsiN«iae>=0; 
STOMETHOD EnumOTteCooQectofs( 

lEiLumConiKctorPAR *FAR ^ppIEnuiuCoDa. 

REFIID DcscIID, 

LPCTSTR lps£N«inft)=0; 
STD METHO D NcwConaocM 

REFIID DcacIID, 

LPCTSTR IpszName, 

ICoittiectot FAR •FAR •ppIOonDectpr>«0; 
STDMETHOD DclcteCoa»ctof(ICoQiieetOf PAR *pICcaaiectOT>=0; 



The con^nent manager provides various interfaces for 
use in man^tging connections between components. Code 
Table 4 contains a description of the IComponcntlack inter- 
face. The interface defines four methods. Thc first two 
methods EnumeratcDescriptors and EnumetateConnectors 
provide a medianismfor enumerating the connector descr^ 
tors and connectors. Thc methods return a pointer to an 
cnumwator interface. The enunocrator interface has a 
method Next that can bc used to retrieve thc connector 
descriptors or connectors serially. The method Enumcrat- 
cDescriptots provides for the enumexatitm of each connector 
descriptor. The method is passed an imerface id. an instance 
name, and a flag. The nwthod returns a pointer to ao 
enumerator for all connecter dcs(x^rto^s or for only those 
connectfM^ descriptors that match the interface id or instance 
name based on the passed flag. Thc method EoumeratcCon- 
ncctors provides for Ae enumeration of each «ctruded 
connector of a specified connector descriptor. Thc method is 
passed an interface id and an instance name to specify a 
connector descriptor and returns a pointer to an enumerator. 

The method NewCooncctor of the IComponentJack inter- 
face extrudes a connector for the specified connector 
descriptor and returns a pointer to thc connector. Tlie method 
is passed an interface id (DescIID) and an instance name of 
a connector descrq)tor (IpszNamc). FIG. 14 is a flow 
diagram of thc mrthod NewConnector of the IComponent- 
Jack interface. In step 1401. the method selects a descriptor 
entry cmesponding to the passed interface id and instance 
name. In step 1402. if no descriptor entry is selected, then 
the mefliod returns an error. In step 1403, the method 
extrudes a coimector entry for selected descriptor entry and 
returns. The method invokes the method Extrude of the 
selected dcsoiptor entry. Thc method DelclcConncctor of 
the ICo^^x>nenUack interface functions in an analogous 
manner to remove an cttruded connector. In a preferred 
embodiment, a descriptor entry contains state information 
including a pointer to the connector descriptors, thc maxi- 
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mum number of connectors that can be extruded for this 
descriptor entry, the number of connectors currently 
extruded, a pointer to the CELisi. connection id generator to 
help in generating unique identiiicrs for its connectors, and 
a flag field to nwinlain the state of the descriptor entry. As 
descTibed below, the state of a descriptor entry can be 
private, projection, or projected. 

CODE TABLE 5 

cla^ IDe»:nploi€iiiiy: lUnknou'n 
1 

CoimectorEnoy FAR • ExtnxJe< 

IComponeat FAR ♦ pICManifesting, 
ULONG CEflag. 
lUaknown Far * pComponeot, 
ICoBDCCtor FAR ♦FAR • ppICoonectorXli 

I; 



Code Table 5 contains a description of the IDcscriptof En- 
try interface; The interface defines the method Extrude that 
returns a pointer to a newly created connector entry. The 
method is passed a pointer to a manifesting con^ncnt 
(pICManifesting) (described below), a flag (CEflag), and a 
pointer to the user component (pConoponent) and returns a 
pointer to newly created connector (ppIConnector). FIG. 15 
is a flow diagram of the method Extrude of the IDcsCTip- 
torEntry interface. In step 1501, if the maximum number of 
connectors for the connector descript(»' has already been 
extruded, then the method returns an error. In step 1502. the 
method creates and initializes a connector entry. In step 
1503. the nu^od links the connector entry into the CEList 
of this descriptor entry. In step 1S04, the method increments 
the number of connectors extruded for this descriptor entry. 
In stq> 1505, the method sets the connection id of the 
connector entry. Each connector entry for a descriptor entry 
has a unique connection id. In step 1506. the method 
increments the connection id generator of this descriptor 
entry. The connection id generator jxovides a unique con- 
nection id. In step 1507, the method invokes the create 
callback of the user component indicated by the connector 
descriptor passing a pointer to the user conqwnent and 
returns. The create callback returns a painter to the Interface 
of the protocol that is provided by the user component In a 
preferred embodiment, a connector entry contains a unique 
connection id for the descriptor entry, a pointer to the 
intcifacc provided by the user component, a reverse inter- 
face pointer, a pointer to a moniker of the mate connector, 
a pointer to the manifesting conqKment. and a flag contain- 
ing state informatioD. The state information indicates 
whether the connecter is connected, connecting, or discon- 
necting and whether die mate is a stub (desoibed below). 

A preferred embodiment provides for "lazy binding" to 
reverse interfaces. When a connection is established with 
lazy biodiog. the reverse interface pointers of the connector 
and the user component are set to point to a stub for the 
reverse interface, and not to the "rcaT reverse interface 
[Tovided by the connected to component The stub is a 
different impIemeniatioD of the reverse interface. When any 
one of the methods of the stub is invoked, the method binds 
to the reverse interface and replaces the reverse interface 
pointers of the connector and the user component with a 
pointer to the bound reverse interface. Each method then 
invokes the ccanrcsponding method of the reverse Interface. 
In this way, the binding to a reverse interface can be delayed 
untiJ the reverse iotcifacc is actually referenced by a user 
component. Each connector descriptor preferably contains a 
pointer to a class factory to create the reverse interface stub. 
Each stub method. aJthou^ implemented by a user compo- 
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ncnt author, invokes predefined functions to retrieve infor- 
mation from the connector needed to bind to the reverse 
interface. Thus, the user component author does not need to 
know the internals of the component manager structure. If a 

s stub class factoiy is not specifled in a connector descriptor, 
then no lazy binding occurs. 

FIG. 16 is a block diagram illustrating lazy binding. When 
a connector entry is first extruded, the connector entry is set 
to point to a stub for the reverse interface. The stub provides 

10 a la^ binding implementation of the reverse interface. 
When a method of the stub is invoked, the method binds to 
the reverse interface indicated by the reverse interface 
moniker (described below) of the connector and then 
invokes the corre^nding method of thai bound interface. 

15 In FIG. 16, the reverse interface pointer (prcvintcrfacc) of 
the connector entry 1601 points to die stub 1603. Also, the 
reverse lotcrface pointer of the user component 1602 points 
to the stub 1603. The stub 1603 contains internal 
information, including a pointer to conncctcn* entry 1601. 

20 The virtual function table 1604 points to each stub method 
1605. When a connection is csublished, the connector entry 
1601 is set to point to a reverse interface moniker 1607. 
When the user coniponent accesses a method throu^ the 
reverse interface pointer, a stub method is invoked. As 

25 illustrated by the pseudocode of method 1 1605. each stub 
method binds to the reverse interface identified by the 
reverse interface moniker, sets the reverse interface pointers 
to point to the bound reverse interface, invokes the cone- 
sponding method of die bound reverse interface, and then 

}0 returns. 

To inq>lcmcnt lazy binding, each component Is assigned 
a conqx^nent moniker that uniquely identifies the compo- 
nent. Each connector generates a connector moniker that 
uniquely defines the connector within die component The 

33 connector moniker contains the interface id, instance name, 
and connection id to provide the unique identification. The 
method GetMoniker (described below) of the IConnector 
interface returns a connector moniker for the connector. 
When a connection is established, each connector is pro- 

40 vided with a connecter moniker for the reverse interface 
(nwnikers are described in detail in U.S. patent application 
Scr. No. 07/08/088.724, enUUed "METHOD AND SYS- 
TEM FOR NAMING AND BINDING OBJECTS." filed 
JuL 6, 1993. now U.S. Pat. No. 3.581.760. which is hereby 

45 incoiporated by reference). When binding through a reverse 
interface stub, the irtethod BindToObjcct of the reverse 
interface moniker is invoked. 

In a preferred embodiment, connections may be desig- 
nated as persistent or Doopersistent in the connector descrip- 

50 tor. A noiq)crsisteiit conDBctor is deallocated when all ref- 
erences to it go away (e.g. reference count equals 0). A 
persistent connector, on the other hand, is not deallocated 
when all references to it go away. When a persistent con- 
nector is connected, a moniker identifying the reverse Inier- 

55 face is stored in the conneaor. The methods of the reverse 
interface stub use this mcHuker to bind to the reverse 
interface. When a nonpersistcnt connector is connected, then 
the reverse interface is bound at that time and the reverse 
interface pointers are set to point to the real reverse intcr- 

60 face. 

An embodiment of the present invention provides for 
multicasting a message to all components connected through 
a protocol. A message is multicastcd by invoking a method 
of each connected connector for a specified connector 
65 descriptor. The function GctMulticastStub returns a pointer 
to a multicast stub ijiq>lementation of the reverse interface. 
The function is passed an interface id and instance name and 
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returns a pointer to the mulUcast stub. To multicast a is currently coimectcd. The method Gctlnfo gathers and 

message, the user component invokes a mcttiod of the returns the interface identifier, the reverse interface id. the 

multicast stub. Each method of the multicast stub invokes instance name, and a status flag of this connector. The 

the conespondiog method of the reverse interface of each method ReleaseMate invokes the method release of the 

connected connector. FIG. 17 is a block diagram iilustraling 5 reverse interface and creates a reverse interface stub. The 

a preferred implementation of the multicast interface stub. method SetMateConneclor sets the reverse interface pointer 

The descriptor entiy 1701 points to connector entries this connector and the user con^jonent to the passed 

1702-1703. Connector entry 1702 is connected but is not yet interface. The method sets this connector to the connected, 

bound; connector entry 1702 points to the lazy binding stub method GctMateConneaor binds to the stub if not 

1704 as its reverse interface pointer. Conneclor entry 1703 already bound and returns the pointer to the reverse inter- 
is bound and points to the reverse interface 1705. The 

multicast stub 1706 points to the descriptor entry 1701. Each component manager provides a mechanism to passi- 
method of the multicast stub 1706 is pointed to through the ^^j^ (unbind) a connection. Either the interface or the 
virtual function table 1707. Each mctfiod of the multicast reverse interface of a connection can be passivated. A 
stub 1708 loops through the connector entry Ust and if a connector is passivated by releasing the reverse interface (if 
connector entry is connected, the method invokes the cot- q^jj ^ reverse interface stub) and replacing it with a reverse 
responding method of the reverse interface. The rautticast- interface stub. The reverse connector is passivated by invok- 
ing of a message is logicaUy equivalent to enumerating each j^^^ ^hc method ReleaseMate of the IConncctoi interface. A 
connector and invoking a method of the reverse interface. A connection is passivated by the method Passive of the 
method that returns a parameter cannot be multicast through ^ iConnector interface. The mediod is passed an indication as 
this mechanism. to whether a reverse Interface stub should be left and 
FIG, 17A is a flow diagram illustrating a sample method whether the mate connector should be passivated also. ¥IG. 
of a stub. The reverse interface stab and a multicast stub |g diagram of the method Passivatc of the ICon- 
share the same Implementation. The stub method loops ncctot interface. In step 1801. if the passed flag indicates to 
invoking the function ConnectorStublmplementation pro- ^ passivate only the connection to the reverse interface, then 
vided by the conqxHient manager. That function returns a method continues at stq> 1806, else the method contin- 
pointer to a reverse interface. The stub method invokes (he ^ ^ jtep 1802, if this connector is not bound 
corresponding method of the reverse Interface. When the ^hc reverse interface or is bound to a reverse interface 
function returns a return value of false, then the stub method ^^^^ ^j^^ method continues at step 1803, else the 
return. When multicasting, the sdib mediod loops receiving ^ method continues at step 1804. In step 1803, the method 
rcvcnc interface pointers. When not multicasting, only one ^ reverse interface and retrieves a pointer to the 
reverse interface pointer is returned. In step 1751, the iconnectorintcrfaccof the mate connector. step 1804, the 
method invokes the function ConnectorStublmplementatioD method retrieves a pointer to the IConnector interface of the 
which returns a reverse interface pointer and a return value. connector. In step 1805. the method invokes the 
Id step 1752. if the return value is false, then the method 35 method ReleaseMate of the mate connector to request the 
returns. In step 1753, the method invokes the cocrcsponding connector to release the interface provided by this 
method of the reverse interface and loops to step 1751. Hie connector. In step 1806, if this connector is bound to a 
fuDCtioD ConnectorStublmplementation detennifles whether reverse intof ace stub, then the method continues at step 
it is being invoked by a reverse intafacc stub or a multicast method continues at step 1809. In step 1807, 
stub by internal information stared in the stub. « if flic passed flag indicates to leave a revase interface stub, 

then the method returns. In step 1808. the method releases 

COD E TABLE 6 the reverse interface stub and sets the reverse interface 

r — Z ^^rZm ' "~~ pointers to NULL and returns. In step 1809. the method 

cUwiCcoDoctorBJobwwn ^^^^^^ ^^^^ interface by invoking the method 

STDMETHOD aeiM«uk«<lMomker FAR -FAR •ppmfcr>=0; 43 Rclcftst. In step 1810, if the passed flag indicates to not leave 

STXAXEmOD GctOwncrOCompooeiii FAR •FAR ^C)=0; ^ method returns. In Step 18U, the method 

US™ .pii^un^PAK « ^ 

UD FAR "piidm, ULONG PAR *pCDflajH>; pointers, and returns. 

STDMETHOD 8efc«*cMite(>=C; The invcTse of passivating a connection is binding to a 

mffiDiOD SetM«ti<:ooi«tar(iUiiki»wo FAR *iJUn^ ^ connection FIG. 19 is a flow diagram of flic method 

^^^^'S^^S?^mnkwv BindStub of the IConnector btcrfacc. In step 1901, if this 

STD^^^r^^ connector is not connected to a stub, then the method returns 

STDMETHOD Bindstub()=0; an error. In step 1902, the noetbod binds to the reverse 

) interface by inv<ddng the method BindToObjcct of the 

—— reverse interface moniker. In step 1903. the method sets this 

Code Table 6 contains a description of the IConnector connector to indicate that it is not connected to a stub. In step 

interface. Each connector entry provides this interface to 1904. the method sets the reverse interface pointers to pomt 

manipulate the connection. The method GetMoniker returns to the bound to reverse interface. In steps 1905 and 1906, the 

the moniker for this connector. The method instantiates a method optionally connects the mate connector and sets its 

connector moniker and sets data members to the interface id, 60 reverse inti^ace pointers. In step 1905, the riiethod retii&ves 

instance name, and connecUon id of this connector. The the IConnector interface of the mate connector. In step 1906. 

method then composes the connector moniker with the the method sets the reverse interface pointers of ttie mate 

component moniker for the manifesting component and connector to point to the interface provided by this conncc- 

retums. The manifesting component is the component that tor and returns. The IConnect interface provides the method 

extrudes this connector. The method GctOwner rcmras a 63 SctMaieConncctor that is passed a pointa to a reverse 

pointer to the manifesting component of this connector. The interface, sets the connector to connected, and sets the 

method IsConnectcd returns the value true if this conneclor reverse interface pointers. 
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A preferred embodiment of Ihe present inveDtion allows 
coinponciits to be embedded within a container component. 
The embedded component is a child component (child), and 
the container coraponeat Is a parent componeat (parent). The 
connector descriptors of the child oompoocnts can be "pro- 
jected" onto the parent coxi^KiDent. To a user of the parent 
con^nent. a projected connector descriptor appears as Just 
another connector of the parent component. FIG. 20 is a 
block diagram illustrating a parent component and a child 
component. A parent is connected to its children throu^ the 
IComponentplug/IComponentFack protocol (parent/diild 
protocol). Each component that is a parent has a connector 
descriptor specifying the IComponcntPlug interface and the 
ICoiDponentJack reverse interface. Thus, the cranector 
descriptor array includes an entry for the IComponeotPlug/ 
IComponenUadc protocol for each component that can be a 
parent component Each component is automatically created 
with a connector desGrq>tor for the ICompoaentlack inter- 
face and IComponcntPlug reverse interface. In this way. any 
components can be embedded within a parent The CEList 
for the descriptor entry for the parent/child protocol contains 
a connector for each child. FIG. 20 shows a parent compo* 
neat 2010 and a child 2020. The parent 2010 conq>rises 
component manager 2011 and a DEList with descriptor 
entries 2012 and 2015. Descriptor entry 2012 supports the 
parent/child protocol. The CEList of dcsoiptor entry 2012 
contahis connectors 2013 and 2014. The connector 2014 b 
connected Co child 2020. The child 2020 comprises conqio- 
nent manager 2021 and a DEUst with descriptor entries 
2022 and 202S. Descriptor entry 2022 supports the parent/ 
chUd protocol. The connecter 2024 connects to the parent 
2010. Descriptor entry 2015 is a projection descriptcr 
entry 2025 of the child onto the parent When a descriptor 
entry is projected from a child onto a parent, a new descrip- 
tor entry is added to the parent with an indication that it is 
a projection. The projected descriptor entry of the child is set 
to indicate that it is projected. When a connector is cxtnidcd 
from a projection descriptor entry, a connector 2016 is 
created for the parent However, as indicated by the dashed 
lines, a projection connector entry does not provide an 
IConnector. Hack, or IPlug interface. Rather, when a con- 
nector is extruded from a projection descriptor entry, ttie 
IConnector interface of the child is returned. The parent 
invokes a method of the child so that the child can extrude 
a corresponding connector 2026. If the child is itself a parent 
and the extruded connecter is a projection, then the child's 
child is Invoked to extrude its connector. The parent and 
child relationships can be to an arbitrary level of nesting. 
When a projected connector is extruded, a pointer to pro- 
jected connector is returned. Thus, connections are estab- 
lished directly to the connector of the child. The 
IConqxinentPlug/ICon^nentJack protocol is an unidirec- 
tional protocol. Hie parent does not provide an iiiq)lemen- 
tation of the IComponentPlug Interface. Ra&er, as with any 
other unidirectional protocol, only the lUnknown interface 
is implemented. The IComponentf ack interface is firovided. 
by the component manager as described above. 

The (Unction ComponentCreateChild creates a child com- 
poneot of the specified class for die specified parent and 
connects the child to the parent The parent con^wnent 
should have a full path moniker, and die function sets the 
parent moniker and this moniker of the child. In a preferred 
embodiment, a component manager contains a fill path 
moniker, a parent moniker, and a this moniker. The parent 
moniker is a moniker that identifies the parent of a child. Hie 
this moniker is a moniker that identifies a child of the parent 
If the component Is not a child, then this moniker identifies 
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the component The full path moniker is the con^sition of 
the parent moniker with the this moniker. A preferred 
prototype of the function ComponentCreateChild is 
STDAPI CompoaentCi-eateChild< 
struct Con^xsnentManager FAR *pComponentManagcr, 
DWORD dwQsContext. 
void FAR *preserved, 
REFCLSID rcid, 
10 lUnknown FAR * FAR * ppComponcntPlug) 

The parameter pComponentManager is a pointer to the 
parent ccxnponent; the parameter dwICIsContcxt and rcid 
represent the class id of the child. The function returns a 
pointer to the IComponcntPlug interface provided by the 
IS parent FIGS. 21A and 21B comprise a a flow diagram of the 
function CompoaeatCreateChild. In step 2101, if the parent 
conqxxtent does not have a full path moniker, then the 
method returns an error. In step 2102. the method selects a 
descriptor «itiy of the parent component for the ICompo- 
20 nentPlug Interface. In step 2103. if Che mediod docs not 
select a descriptor entry, then the nKthod returns an error. In 
step 2104. the method extrudes a connector from selected 
descriptor entry. This connector is used to connect to the 
child. In step 2105. the method retrieves the IQassFactory 
25 inteif&ce for the child as specified by the passed class id. In 
step 2106, the mettiod creates an instance of the child and 
retrieves its IComponent interface. The methods of die 
IComponent interface are described below. In step 2107. the 
method sets the child component to point to its parent 
30 conqwnent invoking the method SeCParentComponent of 
the child. In Acp 2108, the method sets the parent moniker 
of the child by invoking the ntethod SetParentMonikcr of the 
child. In step 2109. the method creates a component moniker 
for the child. The component moniker contains the connec- 
33 tion id of the extruded connector of (he parent to uniquely 
identify the child within the parent In step 2110. the method 
sets the this moniker of die child by invoking the method 
SetChUdMonikier of the child. In step 2111, the method 
releases the created component moniker. In step 2112. the 
40 method extrudes a connector from the descriptor entry for 
the ICon^ncntJackAComponentFlug protocol of the child 
In step 2113. the method invokes ±c hincdon Con^nent- 
Connect to connect the plug connector of the parent to the 
jack connector of the child. In step 2114. the method releases 
43 the jack connector of the child and retiurns. 

TTie function ComponcntProjedDcscriptor projects a 
specified interface of a specified child component onto its 
parent conqx>neDt. The function creates a "projecUoQ" 
descriptor entry for the parent and links it ioto the DEUst 
X The corresponding descriptor entry of the child is set to 
indicated that it is projected. The projection descriptor entry 
is set to the q>ecificd instance name. A prefeired prototype 
for the function Con^nentProjectDescriptor is 
STDAPI ComponcntProjectDescr4)toi( 
S3 struct Con^wnentManager FAR *pConqwnentMaQager. 
lUnknown FAR ^pOiildlConqwncntPlug. 
REFIIDriid, 
LPCrSTR child_Jnamc, 
60 LPCrSTR my_iname. 

ULONG cMaxConnectors); 
The parameter pComponentManager points to the parent 
component; the parameter pChildlComponentPlug points to 
the ICompoDcntPtug interface provided by the parent, the 
65 parameters riid and child_iname specify the interface Id and 
instance name of the child connector to project; the param- 
eter my_name specifies die instance name for the projection 
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descriptor entry; and the pnramctcr cMaxConnectors speci- 
fics thtr maximum count of connectors for the projection 
Jestriptor entry. FIG. 22 is a flow diagram of the function 
ComponcntProjcrtDcscriptor In step 2201. the method 
retrieves the IConnector interface of the child connector. In 5 
step 2202. the method releases the interface In step 2203. 
the method selects a descriptor entry of the child with the 
passed interface id and instance name. In stqj 2204, if the 
method docs not select a descriptor entry, then the method 
returns an error. In step 2205, the method selects a descriptor lO 
entry of the parent with die passed interface id and new 
instance name. In step 2206. if the method selected a 
descriptor entry, then the method returns an error. In step 
2207. the method creates a projection connector entry for the 
parent. In step 2208. the method registers the projection with i3 
the child to indicate to the diild that its descriptor entry is 
□ow projected. The method invokes the method Register- 
Projection of the ICon^wnem interface of the diild. In step 
2209, the method links the projection descriptor entry to the 
DEList of the parent and returns. ^ 

A connector is extruded from a projection descr^of entry 
in an analogous manner lo a non-projection descriptor entry. 
However, the parent notifies the child that a connector is 
being extruded and a pointer to the IConnector interface of 
the child is returned. The parent invokes the method New- 
ProjectedConnector of the ICoraponent interface of the 
child. This method extrudes a connector for the projected 
descriptor entry of the child. If projected descriptor entry is 
itself a projection descriptor entry, then the child's child is 
notified. 

CODE TABLE 7 
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CODE TABLE 8-continucd 



I: 



IMoJiacer FAR •pnikr. 
tMomker PAR 'innklliu; 
IMonikcr FAR •pmkPaicni; 
lUnlmowii FAR *pComponeBC; 
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cbss ICompoDenl-JUnkwwi 



void SetMoiiiker^IMcttiter FAR •pini(r>=0: 

TOid GetMooik«<IMoiiilBtr FAR "FAR •ppinkr)=0-. 

void SetPBreatCoogwoeniqCompcMiBnl FAR •pPwcoaCHJ'. 

vend SclFmaiMfx^ixtOMmukeT FAR •poikPireat>=0; 

void SetChildMooikei^IMoniker FAR 'pmfcCliild>^; 

void PaMivatoCoonectioiii(ULONO (U*)=0; 

wid NwProjectedCoiBKC totaCo ngiOGent FAR 'jJCManifestini, 

REFHD DescIID, LPCTSTR tpiiName, 

ULONO FAR •pcconid, 

IComwctor FAR *FAR *ppI Coiiiw» ctor>=0-. 
void DakieProjectedCoawctoifREFnD DescIID. 

LPCTSTR tptzNan w. UXJ NO coDnid>=0: 
void Re£isteiPn>jcctioa(R£niD rtid LPCTSTR ioanie, 

ULONG FAB •pCDfla«>0; 
void RevokBPioj«tioo(REFnD riid, LPCTSTR inamc)^; 
void DoEtserBtndsOO: 



Code T^le 7 defines the ICoraponent interface that is 
provided by the con^nent manager. The IComponcnt inter- 
face provides methods to manipulate components. Code 
Table 8 defines internal state information of the conopoocnt 
manager. In the following, the methods of the ICon^xjoent 55 
interface are described. 



CODE TABLE 8 



class CompODCOtMsugcr 



ULONO refcounl; 
lUnkaowo FAR •PUnkOmer. 
lUotDown ssgtu: 
IComponcDl FAR 'pPurnl-, 
DcscriptoiEntiy FAR 'pDELisi; 
ULONO DErefcoimi; 

coosl CmnponentDEKKptor FAR •pCoinpDcsc: 



nC. 23 is a flow diagram of the method SctMonikcr of 
the ICoraponent interface. The method SetMoniker is passed 
a pointer to a moniker and sets the full path moniker (pmfcr) 
of this component to point to the passed moniker. In step 

2301. if this con^wnent is a child component, then the 
method returns an error, else the method continues at step 

2302, Id step 2302. if this component already has a fill path 
moniker (pmfcrJ=NULL), then the method returns an ciror. 
else the method continues at step 2303. In step 2303, the 
method sets the full path moniker (pmkr) of this component 
to the passed moniker. In step 2304. the method increments 
the reference count of the passed moniker and rcliims. 

FIG, 24 is a flow diagram of the method GctMonikcr of 
the class ComponentManager. The method GetMoniker 
returns a pointer to the full path moniker for this con^nenL 
In step 2401, if this con^ncnt does not have a full path 
moniker, then the method returns an error. In step 2402. the 
method increments the reference count of the fill path 
moniker and returns. 

FIG. 25 is a flow diagram of the method SetParcntMoni- 
kex of the class ComponentManager. This method sets the 
parent moniker for this conqwnenl to the passed moniker. If 
the conqxjnent currently has a parent moniker, then the 
method releases the current parent moniker. The method also 
sets die parent monilar of all child components. In step 
2501. if this component has a parent moniker (pmkParent). 
35 then the method releases the parent moniker in step 2501 In 
step 2503. if the component has a full path moniker (pmkr), 
then the method releases the full path moniker in step 2504. 
In step 2505. the method sets the parent moniker of this 
component to the passed moniker. In s^ 2506. the method 
40 inaemcnts the reference count (rf the passed moniker. In 
step 2507, if the conoponcnt does not have a this moniker 
(pmkThis), then the method returns. In step 250«, the 
method sets the full path moniker to the composition of the 
parent moniker and the this moniker by invoking the method 
45 Compose With of the parent moniker. In step 2509. the 
method invokes ti»e method Rename to set the parent 
moniker <rf each child con^Kxieni and then returns. 

FIG. 26 is a flow diagram of the private method Rename 
of the IComponcnt interface. The ntethod sets the parent 
moniker of each child component of this component to the 
passed moniker. The method also disconnects connectors. In 
step 2601, the method selects the dcscr^tor entry in the 
DEList for the connector to the child con^nents. In step 
260Z if the descriptor entry is selected, then this corr^ncnt 
may have child components and the method continues at 
step 2603. else the method continues at step 2606. In step 
2603. the method selects the next connector entry for the 
selected descriptor entry, starting with the first connectw 
entry in the CEUst In step 2604, if all the connector entries 
60 have been selected, then the method continues at step 2606. 
else the method continues at step 2605. In step 2605, the 
method sets the parent moniker of the child component 
connected to the selected connector entry by invoking the 
method SetParentMoniker of the duld component. The 
65 method then loops to step 2603 to select the next connector 
entry. In steps 2606 through 26n. the method loops discon- 
necting connectors. In step 2606, the method selects the next 
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descriptor CQtry in the DEList that is not a projection. In step invokes the method BindStub of the IConncctor inicrface of 

2607. the if all the descriptor entries have been selected, then the selected connector entry and loops to step 2905 to select 
the method returns. In step 2608. the method selects the next the next connector entry. 

connector cntiy in the CEUst fra- the selected descriptor Code Tabic 2A contains a definition of the component 

entry that is connected, starting with the first connector 3 descriptor. In the following, the field of the component 

entry. Id step 2609. if all the connector entries have been descriptor is described. 

selected, then the method loops to step 2606 to select the CoraponentDescriptortrcConnectOR 

next descriptor entry, else the method continues at step 2610. This field indicates the number of connector descriptors in 

In step 2610. the method releases the reverse interface of the the array of connector descriptors. 

selected connector entry and sets the reverse interface to lo CoraponcntDescriptor:;pConnDcsc 

NULL. In step 2611, the method releases the reverse inter- This field is a pointer to the connector descriptor array. 

face moniker of the select connector entry, sets the pointer ComponentDcscriptor::Create 

to the reverse interface moniker to NULL, and loops to step This field provides a pointer to a function provided by the 

2608. to select the next connector entry. user component that is invoked when the component is 
FIG. 27 is a flow diagram of the method SetChildMoniker 15 created. The user component is written to be aggrcgatable; 

of the IComponent interface. The method SetChildMoniker the controlling lUnknown passed to this function is provided 

sets the this moniker to the passed moolker. The method also by the component manager. The component manager aggrc- 

invokes the method Rename of the component to rename its gates the user component Into itself. The user component is 

child components. In step 2701, if this component has a this passed a pointer to the conoponcnt manager which can be 
moniker, then the method returns an error a component can 20 used to obtain certain services. The user component provides 

only have its this moniker set once. In step 2702, if this an implementation of the IPcrsist interface. If the user 

con^ncnt has a fuU path moniker, then this component is component is to have persistent slate, it also provides an 

not a child component and the method returns an error. In implementation of the IPersistStorage interface. In this way. 

stq) 2703, if the component does not have a parent moniker, the component manager can ask the user component to 
then the method returns an error because the parent moniker 25 persist itself. 

^ould have been set when this child component was ctc- Code Table 2B contains a description of a connector 

atcd. In step 2704, the method sets the fliis moniker descriptor. In the following, the field of the connector 

(pml^This) of this con^nent to tiic passed moniker. In step descriptor is described. 

2705, the method increments the reference count of the ConnectorDescriptor;:piid 

passed moniker. In step 2706. the method sets flic fUll path so The interface id of the protocol that user component 

moniker of the component to the con^sitioa of the parent provides. 

moniker and the this moniker by invoking the method ConnectorDescrqrtorrpiidm 

CcmiposeWith of the parent moniker. In step 2707, the The reverse interface id of the protocol. 

method invokes the method Rename of this component to ConnectorI>escriptor::iname 

rename its child oon^nents and then returns. 33 The instance name of the protocol This name is used to 

FIG. 28 is a flow diagram of die method SetParcntCom- distinguish between multiple implementations <rf the same 

ponent of the IComponent interface. TTie method SctParcnt- protocol provided by a user oon^und. 

Component sets the parent (pParent) of this component to ConnectorDcscrq)tor::flag 

point to the passed component. This method does not Specifies certain control information about the connector, 

increase the reference count of the parent to avoid circular 40 CNNCrR_PLUG 

references. In step 2801, if this compcmenl has a parent This flag indicates that the user con^wnent in^dcracnts 

con^jonent or die passed component is NULL, then the the plug interface of die protocol 

method returns an eiror. In step 2802, the method sets the CNNCrR_JACK 

parent of this component to die passed oonoponent and This flag indicates that the user component implements 

returns. 45 the jack interface of the protocol. 

FIG, 29 is a flow diagram of the method DoBagerBinds of CNNCTR^REVIOIT 
the IComponent interface. The method binds the stubs fcx aU This flag indicates that the reverse interface on the con- 
connector entries that are not a projection, for which eager ncction is optional This might be used if such an interface 
bind is specified, and that is not already connected. In step is merely informational, or notifies the other component of 
2901, die mediod selects the next descriptor entry of tiiis 50 certain events of which the other component may not be 
component, starting with the first In step 2902. if all the interested in. 
dcsoiptor entries have already been selected, then the CNNCIK^EAGERBIND 

method returns, else the method continues at step 2903. In This flag indicates that the connector is to bind to the 

step 2903. if the selected descrqjtor entry is not a projection. reverse interface as soon as a connection is established, 

then the method continues at ^04, else the method loops to 55 referred to as eager binding. This overrides the default lazy 

step 2901 to select the next descriptor entry. In step 2904, if binding to interfaces, 

the selected descriptor entry indicates eager bind, then the CKNCTFJREVTFTR 

method continues at step 290S, else the method loc^ to step This flag indicates that the user component contains a 

2901 to select the next dcsoiptor entry. In step 2905. die reverse interface pointer, 

method selects the next connector entry for the selected 60 CNNCITO^ONPERSISTENT 

descriptor entry, starting with the first In step 2906. if all the This flag indicates that the connector is not to persist when 

connector entries have already been selected, then the all references to it go away. Such connectors are saved when 

method loops to step 2901 to select the next descriptor entry. a component is saved. These connectors arc kept alive 

else the method continues at step 2907. In step 2907, if die stricUy by virtue of being referenced. Such connectors can 

selected connector entry is connected, then the method loops 63 be created on-demand by clients of a component, and 

to step 2905 to select the next connector entry, else the monikers to them may be treated. Typically, some service 

method continues at step 2908. In step 2908, the method type component, which never initiates a connection on a 
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bidirectional protocol, or which provides the impiementa- teDt storage SOWkJie computer 3001 iDcludes a ccMral 

jccted or extruded to Ac outside of a con^wnen . but IS oM^ 5 J^^^^^^^^^ componentlon the display device. A 
available for coonecUng from 1^*= JJ^j programmer using theTput device selects which Usted 
component. Such a connector is not listed m dcscnptor ^ -^^^^^ ^ program. The visual program- 
enumerators or connector enumerators that arc CTcated from j^Z\nsintigcT crates an instance of each selected compo- 
outside the component, but will be seen by such when they j^^ni. Aim the coII^X)ncnts arc selected, then the program- 
arc created from within the component. to specifies how to interconnect the components. Each 
CNNCrR_AGGREGArE component fs-ovidcs a Ust of protocols that it supports. The 
This flag directs the component manager to aggregate the ^^^^^ programming naanager displays the lists on the dis- 
inletface of this connector into the component manager and pj^y device. The programmer specifies two components to 
not to assume that the only interface on the connector is the connect through a protocol. The visual prt^amming man- 
one given in the connector descriptor. When an interface is ager directs the specified con^>onenis to extrude connectors 
other than the one specified by pUd is requested, the com- for the protocol. The visual programming manager then 
ponent manager invokes the lUnknown of the reverse inter- directs the extruded connectors to connect, 
f^ce FIG. 31 is a diagram of the dispUy of a sample visual 
ConnectorI>escriplor::cMaxConnectors program. The visual program displays a saoU bar 3101 and 
This field specifics an initial limit on how many instances 20 a display box 3102. The display box display a numenc value 
of this conneSor may be extruded from the component at between 0 ai>d 100 that corresponds to the posiUon of Ac 
^y one^ The Lmponeni may adjust thiTvalue at scroU bar thumb. When Uie thumb is moved by a user die 
7n-^ m ad ostcTX is persist aaoss subsequent value in the display box is f ^^.^^""y "P?**^^^ 
lua umc. I nc oujuoii^ TBiw ^ Conversely, when a new value is entered into the di^lay box 
acUvatioDs of the component, and devalue specked ha^ by a ulS L thuinb is automaticaUy moved accor^^^^ 
just the default for a "cwly jeated ms^cc of toe comp<v 25 ^^^^ programmer selerts a scroU bar 
neat TTie value UIX)NG_MAX specifies that thore is no boi coliipoDcm and then connects 
limit to the number of instances thai may be extruded, the Mmponcnts. 

CoancctorDescriptor::RevIfaccPtrOff pjQ 32 a block diagram of the instantiated compo- 

This field contains the offset within the user component ^^^^ scroUbar component 3201 is shown with jack 

(from the interface) of the reverse interface pointer. 30 3202 extruded. The display box conqwncnt 3203 is shown 

ConncctorDc$criptor::OutStubf with plug 3204 extruded The jack 3202 and 3204 arc 

These fields contain pointers to stub class factories for the connected. In operation, the scroll bar conqwnent effects the 

particular protocol. display of scroil bar 3101. and the display box component 

ConnectorDescriptor-Create 3203 effects the display of display box 3102. When the 

This field contains a pointer to a function in the user 35 thumb is moved, the opaating system sends a message to 

component that returns a pointer to the interface. This the scroll bar component. In response to tiie message, the 

function is invoked when a connector is extruded. This scroU bar component multicasts the message through its 

function returns a pointer to the interface. extruded jack. Hie display box component receives the 

CoonectorDesaiptS:Delete message and changes its display box aaonUn^^^^^^^ 

Tliis field oonZons a pointer to a function provided by the 40 when a user enters a new value "I*^ ^P*«y^^' 

usercomponentwhichrinvokedwhenaconnectcistobe ^^^^^^J^^^^^^ 

deleted. , , _ ^ the message to the jacks connected through the protocol. The 

ConnectorDcsoriptorK:otinect ^-^^^^^y,,^, scroU bar component revives the message and changes the 

This field contains a pointer to a function provided by the iI^k 

usa component that is invok«l when a connection occurs 45 thumb ac«r(L^^ ^^^^ 

controlling calls dunng its connecOon nouncatioa. The 50 , . . An^, 

^catic^ comes after the connection is estabUshed. and by the claims that follow. 

_* J f We clAunt 
the mterfaccs are ready for use. ^ ^ ^ ^ computer system for notifying a plurality 
ConnectorDcscnptor::Disconnect of cUcnt coimoncnts connected to a scrvex component each 
ThisfiddcontauisapjHnt^toafiincUonpro^^ l^nt^^m fc^vlng a client component Xf ace with 
user component that is invoked "^'^^J^^^^^HJ^J' " a functioZembcr, the server con^,o2ent having a compo- 
connected This provides an (jjpj^ ^ compon^ the component man- 
cleanup, nie plug end is noufi^ first and then the jack end connecting die cUcTTcomponents to the server 
After both ends have been notified of the disconnecUon. the ''^^J^ tofc^nent managXving a reference to 

actual disconnect occurs. - „„^^n.crr,ntnr..«:«ve M the cUent component interface of each connected cUent 

ConDcctorDescnptor:d-oad and ConneclcirDcscnptOT,.iavc 60 M.7-l-.fc-^ ^«««^<.inn. 

These fields «ntain pointers to functions provided by the con^nent. the meUiod comprising 
us<T component that aiTinvoked to load and save informa- under control of the component ^^'f^^^.l 
tion. aTi component may save state informaUon associ- mulucastmg object having an implementation of the 

ati wim a con^lJ^on aaoss activations of the component function member of the cUen. component interface; 

no 30 is a block diagram Ulustrating a sample system 65 under control of the user component, mvokmg the ftinc- 
using the present invention. TTie computer 3001 is connected tion member of the cUent component interface of the 

to display device 3002. an input device 3003, and a pcr&is- multicasting object; and 
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UDdcr control of the invoked function member of the 
client compoDCDt interface of the multicasting object, 
for cad) of the client components, 
retrieving the reference to the client compooeot 

interface: and 3 
invoking the function member of the client con^ 
ncnt interface referenced by the retrieved refer- 
ence. 

2. A corapjter readable mcmoiy device for controlling a 
computer in accordance with the method of claim 1. lo 

3. A method in a computer system for sending a message 
to a plurality of client components connected to a server 
component, each client component providing a client com- 
ponent interface, the client con^wnent interface having a 
function member, the server component having a reference is 
to the client component interface of cad) client component, 
die method comprising: 

creating a multicasting object having an implementation 
of the function member of the client component inter- 
face; 20 
invoking the function member of the client component 

interface of the multicasting object; and 
under control of the invoked function member of die 
client component interface of the multicasting object, 
for eadi of the client oonoponents. 
retrieving the reference to Ihe client component 

interface of the client component; and 
invoking the function member of the client compo- 
nent interface referenced by the retrieved refer- 
ence. 

4. The metiiod of claim 3 whCTcin the server conqwncnt 
has a component manager and a user coiiqx>nent and indud- 
ing the step of under control of tfic user component request- 
ing the component manager to create the multicasting object 
and wherein the step of creating is pcrfonncd by the com- 
ponent manager and the step of invoking the Ainction 
member the client conqwnent interface of die multicast- 
ing object is performed by the user component. 

5. The method of daim 4 wherein the client component 
interface includes a plurality of function members and 
induding selecting a function member of the diem compo- 
nent interface through which to send the message to the 
dient con^Kinent such thai the stqis of invoking the function 
member o( the client comptuient interface invokes the 
selected function member. 

6. The method of daim 3 induding f<x each client 
conqxHient. creating a connector object and storing the 
reference to the client component interface in the created 
connector bbjccL 

7. A con^uter system for multicasting a message com- 
prising: 

means for connecting a plurality of client oompooents to 
a server component, each cUent component having a 
client ccnnponent interface with a plurality of member 
functions; 

means for creating a multicasting object, the multicasting 
object having an implementation of eacb function 
member of the client component interface, each in^lc- 
mentation for retrieving the references to each diem ^ 
component interface and invoking the function member 
referenced by each retrieved reference; 

means for selecting a function member of the dient 
component interface; and 

means for invoking the selected function member of the 65 
client con^nent interface of the created multicasting 
object, wherein tfie selected function member invokes 
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the selected function member of the client component 
Interface of each client component. 

8. A method in a computer system for delayed binding to 
a first component interface of a first con^nent. the first 
component being connected to a second con^Mnent. the first 
component interface having a function member, the method 
comprising: 

acting a delayed binding object having an implementa- 
tion of the function member of the first component 
interface; 

storing a reference to the delayed binding object; 
when the second component is to invoke the function 

member of the first component interface of the first 

component, 

retrieving the stored reference; 
when the retrieved reference refers to the delayed 
binding object, 

invoking the function member of the first con^x>ncnt 
interface of the delayed binding object; and 

under control of the invoked function member of the 
delayed binding object. 

binding to the first component interface of the 
first component to generate a reference to the 
first component interface of the first compo- 
nent; 

replacing the stored reference to the delayed 
binding object with the generated reference to 
tiic first component interface of the first com- 
ponent; and 

invoking the function member of die first com- 
ponent intarface of the first component; and 
when the retrieved reference refers to the first con^>o- 
oent interface of the first conqwncDt, invoking the 
function member of the first component interface of 
the first component whereby binding to Ihe first 
component interface of the first con^x>nent is 
delayed until a function member of the first con^ 
nent interface of the first component is to be invoked 
by the second ccm^ncnt. 

9. The method of claim 8 wherein the second conqwncnt 
indudes a component manager and a user component, 
wherein ttie component manager creates the dciayed binding 
object and passes the reference to the delayed binding object 
to the user component, and wherein the user component 
stores the passed reference, retrieves the stored reference, 
and invokes the function member of die interface referenced 
by the retrieved reference. 

10. A computer readable oKmory device for controlling a 
computer in accordance with claim 9. 

IL A computer system for delayed binding to a first 
component interface of a first component, a second compo- 
nent being connected to the first component throu^ the first 
component interface, the first component interface having a 
functicMi member, comprising: 
means for creating a delayed binding object having an 
implementation of Che function mend>er of the first 
component interface, the iiiq}lementation of die func- 
tion member for binding to the first con^nent inta- 
face <^ the first component to generate a reference to 
the first con^nent interface of the first component, for 
rq>lacing a reference to the first con^wncnt interface of 
the delayed binding object with the reference to the first 
component interface of the first componcot. and for 
using the generated reference to invoke the fiinction 
mcmba of the first conqxjnent interface of the first 
component; 

means for staring the reference to first component inter- 
face of the aeated delayed binding object; and 
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means for retrieving the stored reference when mvoking 
the function member of the first component interface of 
the first component, wherein 
when the retrieved reference refers to the first compo- 
nent interface of the delayed binding object, invok- 5 
ing the function member of the first componeot 
interface of the delayed binding object to bind to the 
first componeot interface of the first component to 
generate the reference to the first component inter- 
face of the first compoocnt. to replace the reference lO 
to the first component interface of the delayed bind- 
ing object with Ac reference to the first conqwnent 
interface of the first component, and to use the 
generated reference to invoke the fuDction merober 
of the first component interface of the first compo- 15 
ncot; and 

when the retrieved reference refers to the first compo- 
nent iDtcrfacc of the first component, invoking the 
function member of the first corapODCOt interface of 
the first component 20 

12. A method in a con^xiter system for interconnecting 
two componenu, the method comprising the conoputer- 
implemcntcd steps of: 

creating a first con^wnent having a first con^XKieDt 

interface; 
creating a second coit^xmcnt; 

creating a first connector object having a pointer to the 
first component interface; 

creating a second connector object having a reference to 30 
a location in the second component; and 

connecting the first component to the second coii^xMient 
by specifying the first connector object and the second 
connector object, by retrieving the pointer to the first 
component interface from the first connector object, by 35 
retrieving the reference to the location in the second 
component from the second connector object, and by 
storing the retrieved pointer in flic referenced location. 

whereby the second component can access services of the 
first component interface through Ac ptMntcr stored at *° 
the referenced location. 

13. A method in a con^ter system for interconnecting 
two components, the method comprising the con?)Uter- 
implemented steps of: 

creating a first component having a first component 
interface; 

creating a second component having a location for storing 
a pointer to an interface of a component to which Ac 
second conqwnent is ccmnected; 

generating a pointer to the first component interface; 



32 

generating a reference to the location in the second 
component; and 

connecting the first component to the second component 
by specifying the pointer to the first conqroneni inter- 
face and the reference to the location in the second 
component and by storing the pointer in the referenced 
location. 

whereby the second component can access services of the 
first component interface through the pointer stored at 
the referenced location. 

14. A con^utcr readable memory device for controlling a 
counter in accordance with the method of daim 13. 

15. A method in a computer system for interconnecting a 
first component to a second component, the method com- 
prising: 

creating the first component as a combination of a first 
instance of a component manager and a first user 
component, the con^X)0ent manager for managing the 
connecting of components, the first user con^nent 
having a first user component interface; 

creating the second component as a combioation of a 
second instance of the conq>onent manager with a 
second user component; 

under control of Ac first instance of Ac component 
manager, generating a pointer to Ae first user compo- 
nent intoface; 

under Ae control of the second instance of Ae com^wncnt 
manager generating a reference to a location in Ae 
second user component; and 

conncctiog Ac first component to Ae second component 
by specifying Ac pointer to Ae first user component 
interface and Ae reference to the location in the second 
user component, and by storing the retrieved pointer in 
Ae referenced location 

whereby Ac second user component can access services 
of Ac first user conoponent interface through the pointer 
stored at Ac referenced location. 

16. The method of claim 15 wherein Ae step of generating 
a pointer to Ac first user component interface includes Ae 
step of receiving Ae pointer to Ae first user component 
interface fiora Ac first user component. 

17. The mcAod of claim 15 including: 

storing the generated pointer in a first connector object; 
storing the generated reference in Ae scctmd connector 
object; and 

specifying Ac pointer and Ae reference includes speci- 
fying Ae first and second conncrtOT objects. 

***** 
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